MarineTraffic MCP Server

海上交通MCP服务器

](https://smithery.ai/server/@Cyreslab-AI/marinetraffic-mcp-server)

一种模型上下文协议（MCP）服务器，提供对海上交通船只跟踪数据的访问。

特性

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

工具

• 获取容器位置：通过MMSI或IMO编号获取船舶的实时位置
• get_vessel-details：通过MMSI或IMO编号获取船舶的详细信息
• search_vessels：按名称、MMSI、IMO或船舶类型搜索船舶
• get_vessels_in_area：让船只进入指定的地理区域

资源

• 容器：//{标识符}：按MMSI或IMO编号提供的船舶信息
• vessels://area/{lat}/{lon}/{radius}：特定地理区域内的船只清单

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面版的海上交通船舶跟踪服务器 史密瑟里:

npx -y @smithery/cli install @Cyreslab-AI/marinetraffic-mcp-server --client claude

先决条件

• Node.js 18或更高版本
• MarineTraffic API密钥（可从 MarineTraffic API服务)

设置

1. 克隆此存储库或下载源代码
2. 安装依赖项：

cd marinetraffic-server
npm install

1. 构建服务器：

npm run build

配置

服务器需要MarineTraffic 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一起使用，以访问船舶跟踪数据：

获取船舶位置

marinetraffic
get_vessel_position

{
  "identifier": "123456789"
}

搜索船只

marinetraffic
search_vessels

{
  "vessel_name": "MAERSK"
}

让船只进入该区域

marinetraffic
get_vessels_in_area

{
  "latitude": 37.8199,
  "longitude": -122.4783,
  "radius": 10
}

访问船舶资源

marinetraffic
vessel://123456789

API关键限制

MarineTraffic API的使用限制取决于您的订阅计划。使用服务器时请注意这些限制，以避免超出配额。

故障排除

• API密钥错误：确保您的MarineTraffic API密钥有效，并且在环境变量中设置正确。
• 速率限制：如果遇到速率限制错误，服务器将自动以指数回退方式重试，但您可能需要等待才能发出其他请求。

_API提供的详细船只信息示例_

API关键限制

MarineTraffic API的使用限制取决于您的订阅计划。使用服务器时请注意这些限制，以避免超出配额。

故障排除

• API密钥错误：确保您的MarineTraffic API密钥有效，并且在环境变量中设置正确。
• 速率限制：如果遇到速率限制错误，服务器将自动以指数回退方式重试，但您可能需要等待才能发出其他请求。
• 未找到数据：有些船只可能没有实时跟踪数据，特别是小型船只或AIS覆盖范围有限的船只。

许可证

该项目根据ISC许可证获得许可。