mcpField
O
Opendock

Opendock

本地服务
github.com/Pollamin地图与出行236 周前更新

关于 Opendock

Opendock 是连接 AI 助手与 Opendock Neutron API 的 MCP 服务,提供仓库、预约、承运商和运营指标等操作工具。

主要功能

  1. 01管理仓库、码头和货物类型
  2. 02创建和管理预约
  3. 03搜索承运商与公司
  4. 04查询预约及仓库指标
  5. 05使用账号凭据或 JWT 认证

适用场景

  1. 01查看码头可用情况和仓库信息
  2. 02安排或更新仓库预约
  3. 03分析预约量和停留时间

MCP 相关

将 Opendock Neutron API 操作作为工具提供给 MCP 客户端,涵盖预约、仓库、承运商和指标功能。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"opendock": {
"command": "npx",
"args": [
"-y",
"opendock-mcp"
]
}
}
}
启动命令npx -y opendock-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmopendock-mcp5.1.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

Opendock MCP 服务

npm version

一个 MCP 服务,可将 AI 助手(Claude 等)连接到广受赞誉的 Opendock Neutron API。

安装

无需克隆或构建,只需使用 npx:

npx -y opendock-mcp

或全局安装:

npm install -g opendock-mcp

工具

涵盖 11 个类别的 69 个工具:

类别工具
常规get_version, get_profile
仓库list_warehouses, get_warehouse, get_warehouse_hours, create_warehouse, update_warehouse, delete_warehouse
月台list_docks, get_dock, create_dock, update_dock, delete_dock, sort_docks, get_dock_availability
货物类型list_load_types, get_load_type, get_load_type_availability, create_load_type, update_load_type, delete_load_type
预约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
承运商list_carriers, get_carrier, create_carrier, update_carrier, get_booked_carriers
公司list_companies, get_company, create_company
组织get_org, update_org, update_favorite_carriers
审计日志get_audit_log
设置元数据get_settings_metadata, get_setting_metadata, validate_settings_metadata
指标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

前提条件

  • Node.js 18+
  • 拥有 API 访问权限的 Opendock 账户

身份验证

该服务支持两种身份验证方式:

选项 1:用户名/密码(推荐)——服务会自动处理登录和令牌刷新。

[email protected]
OPENDOCK_PASSWORD=your-password

选项 2:使用已有的 JWT 令牌

OPENDOCK_TOKEN=your-jwt-token

也可以设置 API URL:

OPENDOCK_API_URL=https://neutron.opendock.com           # production (default)
OPENDOCK_API_URL=https://neutron.staging.opendock.com    # staging

在 Claude Desktop 中使用

添加到你的 claude_desktop_config.json 中:

{
  "mcpServers": {
    "opendock": {
      "command": "npx",
      "args": ["-y", "opendock-mcp"],
      "env": {
        "OPENDOCK_USERNAME": "[email protected]",
        "OPENDOCK_PASSWORD": "your-password"
      }
    }
  }
}

在 Claude Code 中使用

claude mcp add opendock -- npx -y opendock-mcp

启动 Claude Code 前设置所需的环境变量,或在 MCP 配置中传入这些变量。

测试

使用 MCP Inspector 进行交互式测试:

[email protected] OPENDOCK_PASSWORD=your-password \
  npx @modelcontextprotocol/inspector npx -y opendock-mcp

开发

git clone https://github.com/Pollamin/opendock-mcp.git
cd opendock-mcp
npm install
npm run build

许可证

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。