التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
opendock-mcpclaude mcp add opendock -- npx -y opendock-mcp@5.1.1
{
"mcpServers": {
"opendock": {
"command": "npx",
"args": [
"-y",
"opendock-mcp@5.1.1"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
Opendock MCP Server
An MCP server that connects AI assistants (Claude, etc.) to the legendary Opendock Neutron API.
Install
No clone or build needed — just use npx:
npx -y opendock-mcp
Or install globally:
npm install -g opendock-mcp
Tools
69 tools across 11 categories:
| Category | Tools |
|---|---|
| General | get_version, get_profile |
| Warehouses | list_warehouses, get_warehouse, get_warehouse_hours, create_warehouse, update_warehouse, delete_warehouse |
| Docks | list_docks, get_dock, create_dock, update_dock, delete_dock, sort_docks, get_dock_availability |
| Load Types | list_load_types, get_load_type, get_load_type_availability, create_load_type, update_load_type, delete_load_type |
| Appointments | list_appointments, search_appointments, get_appointment, create_appointment, update_appointment, delete_appointment, get_public_appointment, undo_appointment_status, create_recurring_appointments, delete_recurring_appointments, add_appointment_tag, remove_appointment_tag |
| Carriers | list_carriers, get_carrier, create_carrier, update_carrier, get_booked_carriers |
| Companies | list_companies, get_company, create_company |
| Orgs | get_org, update_org, update_favorite_carriers |
| Audit Log | get_audit_log |
| Settings Metadata | get_settings_metadata, get_setting_metadata, validate_settings_metadata |
| Metrics | get_appointment_volume_by_date, get_appointment_volume_by_carrier, get_appointment_volume_by_load_type, get_appointment_volume_by_time_of_day, get_appointment_volume_by_day_of_week, get_appointment_avg_duration_by_load_type, get_appointment_avg_duration_by_status, get_appointment_avg_duration_by_dock_and_status, get_appointment_count_for_carrier, get_appointment_count_by_status_for_carrier, get_appointment_count_for_docks, get_reserve_count_for_user, get_dock_dwell_time, get_carrier_status_percentages, list_appointment_metrics, export_appointment_metrics_excel, get_appointment_status_times, get_first_available_appointment, get_warehouse_insights, get_warehouse_capacity_usage, export_yard_data_excel |
Prerequisites
- Node.js 18+
- An Opendock account with API access
Authentication
The server supports two authentication methods:
Option 1: Username/password (recommended) — the server handles login and token refresh automatically.
OPENDOCK_USERNAME=user@example.com
OPENDOCK_PASSWORD=your-password
Option 2: Pre-existing JWT token
OPENDOCK_TOKEN=your-jwt-token
Optionally set the API URL:
OPENDOCK_API_URL=https://neutron.opendock.com # production (default)
OPENDOCK_API_URL=https://neutron.staging.opendock.com # staging
Usage with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"opendock": {
"command": "npx",
"args": ["-y", "opendock-mcp"],
"env": {
"OPENDOCK_USERNAME": "user@example.com",
"OPENDOCK_PASSWORD": "your-password"
}
}
}
}
Usage with Claude Code
claude mcp add opendock -- npx -y opendock-mcp
Set the required environment variables before launching Claude Code, or pass them in the MCP config.
Testing
Use the MCP Inspector to test interactively:
OPENDOCK_USERNAME=user@example.com OPENDOCK_PASSWORD=your-password \
npx @modelcontextprotocol/inspector npx -y opendock-mcp
Development
git clone https://github.com/Pollamin/opendock-mcp.git
cd opendock-mcp
npm install
npm run build
License
MIT
الأسئلة الشائعة
ما هو io.github.Pollamin/opendock؟
MCP for the Opendock Neutron API.
كيف أثبّت io.github.Pollamin/opendock؟
يعمل على جهازك. في Claude Code: claude mcp add opendock -- npx -y opendock-mcp@5.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.Pollamin/opendock إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل io.github.Pollamin/opendock مفتوح المصدر؟
شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.
من يصون io.github.Pollamin/opendock؟
ينشره Pollamin. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.