海上交通MCP服务器
一种模型上下文协议（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服务)
设置
- 克隆此存储库或下载源代码
- 安装依赖项：
cd marinetraffic-server
npm install- 构建服务器：
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许可证获得许可。