Marinetraffic MCP Server

🚀 海事交通 MCP 服务器

这是一个模型上下文协议（MCP）服务器，它能提供对海事交通船舶跟踪数据的访问，帮助用户轻松获取各类船舶信息。

🚀 快速开始

此 MCP 服务器允许用户通过特定工具和资源访问海事交通船舶跟踪数据。在使用前，你需要完成安装和配置。

✨ 主要特性

此 MCP 服务器提供了以下功能：

工具

• get_vessel_position：你可以通过 MMSI 或 IMO 号码获取船只实时位置。
• get_vessel_details：借助 MMSI 或 IMO 号码获取船只详细信息。
• search_vessels：可按名称、MMSI、IMO 或船型搜索船只。
• get_vessels_in_area：获取指定地理区域内的船只。

资源

• vessel://{identifier}：通过 MMSI 或 IMO 号码获取船只信息。
• vessels://area/{lat}/{lon}/{radius}：列出指定地理区域内的船只。

📦 安装指南

先决条件

• Node.js 18 或更高版本。
• 海事交通 API 密钥（可从 海事交通 API 服务 获取）。

设置

1. 克隆此仓库或下载源代码。
2. 安装依赖：

cd marinetraffic-server
npm install

3. 构建服务器：

npm run build

📚 详细文档

配置

该服务器需要一个海事交通 API 密钥才能运行。你可以通过环境变量 MARINETRAFFIC_API_KEY 提供此密钥。

MCP 设置配置

要在 Claude 中使用此服务器，请将其添加到你的 MCP 设置配置文件中：

对于 Claude 桌面应用（macOS）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "marinetraffic": {
      "command": "node",
      "args": ["/path/to/marinetraffic-server/build/index.js"],
      "env": {
        "MARINETRAFFIC_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

对于 Claude VSCode 插件

编辑 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json：

{
  "mcpServers": {
    "marinetraffic": {
      "command": "node",
      "args": ["/path/to/marinetraffic-server/build/index.js"],
      "env": {
        "MARINETRAFFIC_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

💻 使用示例

基础用法

一旦服务器配置并运行，你可以使用 Claude 进行以下操作：

• 获取船只实时位置：get_vessel_position
• 获取船只详细信息：get_vessel_details
• 搜索船只：search_vessels
• 获取区域内船只：get_vessels_in_area

📄 许可证

该项目根据 ISC 许可证发布。