MarineTraffic MCP 服务器

提供对 MarineTraffic 船舶跟踪数据的访问的模型上下文协议 (MCP) 服务器。

特征

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

工具

• get_vessel_position ：通过 MMSI 或 IMO 编号获取船舶的实时位置

• get_vessel_details ：通过 MMSI 或 IMO 编号获取船舶的详细信息

• search_vessels ：按名称、MMSI、IMO 或船舶类型搜索船舶

• get_vessels_in_area ：获取指定地理区域内的船只

资源

• 船舶：//{identifier} ：通过 MMSI 或 IMO 编号获取船舶信息

• vessels://area/{lat}/{lon}/{radius} ：指定地理区域内的船只列表

Related MCP server: Satellite Tracking MCP Server

安装

先决条件

• Node.js 18 或更高版本

• MarineTraffic API 密钥（可从MarineTraffic API 服务获取）

设置

1. 克隆此存储库或下载源代码

2. 安装依赖项：

3. 构建服务器：

配置

服务器需要 MarineTraffic API 密钥才能运行。您可以通过环境变量MARINETRAFFIC_API_KEY提供此密钥。

MCP 设置配置

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

适用于 Claude 桌面应用程序 (macOS)

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

对于 Claude VSCode 扩展

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

使用示例

一旦服务器配置并运行，您就可以使用它与 Claude 访问船舶跟踪数据：

获取船舶位置

搜索船只

获取区域内的船只

获取船舶资源

API 密钥限制

MarineTraffic API 的使用量会根据您的订阅计划有所限制。使用服务器时请注意这些限制，以免超出您的配额。

故障排除

• API 密钥错误：确保您的 MarineTraffic API 密钥有效并在环境变量中正确设置。

• 速率限制：如果您遇到速率限制错误，服务器将自动使用指数退避算法重试，但您可能需要等待一段时间才能发出其他请求。以下是通过 API 获取的船舶详细信息示例

API 密钥限制

MarineTraffic API 的使用量会根据您的订阅计划有所限制。使用服务器时请注意这些限制，以免超出您的配额。

故障排除

• API 密钥错误：确保您的 MarineTraffic API 密钥有效并在环境变量中正确设置。

• 速率限制：如果遇到速率限制错误，服务器将自动以指数退避重试，但您可能需要等待才能发出其他请求。

• 未找到数据：某些船只可能没有实时跟踪数据，尤其是较小的船只或 AIS 覆盖有限的区域的船只。

执照

该项目已获得 ISC 许可。