linker-ship-mcp

船舶数据 MCP Server，提供船舶实时位置、档案、靠泊记录、历史轨迹、港口信息和船队管理六类查询能力。

功能概览

| 工具 | 数据源 | 说明 | |------|--------|------| | search_ships | 船舶实时位置 | 按船名/MMSI/船型搜索，返回当前位置与航行状态 | | get_ship_info | 船舶档案 | MMSI/IMO 查询船舶静态信息（尺度/载重/船东/制裁） | | get_ship_berthing | 靠泊记录 | 指定船舶的历史靠泊记录（港口/时间/货物） | | query_port | 港口信息 | 港口在港船舶列表 或 港口靠港统计 | | get_ship_track | 历史轨迹 | AIS 轨迹点（TSV 格式，约省 40% token） | | manage_fleets | 船队管理 | 列出用户的船队 或 查看船队成员实时位置 |

数据来源：Linker 船舶数据库（linker_ship），实时位置约 5-10 分钟更新。

快速开始

安装依赖 & 构建

cd packages/linker-ship-mcp
npm install
npm run build

本地测试

node dist/index.js

看到 linker-ship-mcp started 即启动成功。

客户端配置

Claude Desktop

编辑 claude_desktop_config.json：

{
  "mcpServers": {
    "linker-ship": {
      "command": "npx",
      "args": ["-y", "linker-ship-mcp@latest"],
      "env": {
        "SHIP_API_BASE": "http://hub.linker.net/api/mcp-ship",
        "SHIP_API_KEY": "trading-prod-20260323"
      }
    }
  }
}

Cursor（编辑器 MCP）

.cursor/mcp.json，结构同上。

Claude Code（CLI）

项目根目录 .mcp.json：

{
  "mcpServers": {
    "linker-ship": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "linker-ship-mcp@latest"],
      "env": {
        "SHIP_API_BASE": "http://hub.linker.net/api/mcp-ship",
        "SHIP_API_KEY": "trading-prod-20260323"
      }
    }
  }
}

或命令行：

claude mcp add linker-ship \
  --env SHIP_API_BASE=http://hub.linker.net/api/mcp-ship \
  --env SHIP_API_KEY=trading-prod-20260323 \
  -- npx -y linker-ship-mcp@latest

环境变量说明

| 变量 | 必填 | 说明 | |------|------|------| | SHIP_API_BASE | 否 | 船舶 API 地址，默认 http://hub.linker.net/api/mcp-ship | | SHIP_API_KEY | 否 | 船舶 API 认证 Key，默认 trading-prod-20260323 | | REQUEST_TIMEOUT | 否 | 单次请求超时(ms)，默认 15000 |

发布

cd packages/linker-ship-mcp
npm run build
npm publish --access public

技术栈

• TypeScript (ESM) + Node.js >= 18
• @modelcontextprotocol/sdk — MCP 协议 SDK
• zod — 参数校验