article
README
🚀 海事交通 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 服务 获取)。
设置
- 克隆此仓库或下载源代码。
- 安装依赖:
cd marinetraffic-server
npm install
- 构建服务器:
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 许可证发布。
微信扫一扫