VesselAPI MCP服务器
 ](https://www.npmjs.com/package/vesselapi-mcp) ](https://www.npmjs.com/package/vesselapi-mcp) 
一 MCP（模型上下文协议） 从中公开海事数据的服务器 VesselAPI 像Claude Desktop、Cursor、Windsurf和Claude Code这样的人工智能助手。
先决条件
- 注册地址： dashboard.vesselapi.com
- 在仪表板中创建API令牌
- 将令牌用作
VESSELAPI_API_KEY在下面的配置中
资源: 文档 | API资源管理器 | 仪表盘 | 联系支持
特性
- 23工具 涵盖船舶、港口、位置搜索、排放和海上安全
- 船舶搜索、位置（单个和批量）、预计到达时间、分类、所有权、排放、检查和伤亡
- 港口搜索、详细信息、港口事件（到达/离开）和全球港口事件搜索
- 地理船只搜索（边界框和半径）
- NAVTEX海上安全信息
- 手动分页以控制API配额的使用
托管部署
托管部署可在 Frontier AI.
快速开始
无需安装——只需配置您的AI客户端 npx:
{
"mcpServers": {
"vesselapi": {
"command": "npx",
"args": ["-y", "vesselapi-mcp"],
"env": {
"VESSELAPI_API_KEY": "your-api-key"
}
}
}
}配置
将上面的JSON添加到客户端的配置文件中：
| 客户端 | 配置文件 |
|---|---|
| 克劳德桌面 | ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows） |
| 光标 | .cursor/mcp.json 或 ~/.cursor/mcp.json |
| 克劳德代码 | .claude/settings.json 或 ~/.claude/settings.json |
| 风帆冲浪 | ~/.codeium/windsurf/mcp_config.json |
工具
船舶工具
| 工具 | 说明 |
|---|---|
search_vessels | 按名称、IMO、MMSI、船旗、类型、呼号、建造年份、船级社或船东搜索船舶 |
get_vessel | 获取详细的船舶信息 |
get_vessel_position | 获取当前船舶位置（纬度/经度、速度、航向） |
get_vessel_eta | 获取船舶预计到达时间 |
get_vessel_classification | 获取分类详细信息（船级社、调查、船体） |
get_vessel_ownership | 获取所有权详细信息（所有者、经理、运营商） |
get_vessel_emissions | 获取排放数据（二氧化碳、燃料消耗） |
get_vessel_inspections | 进行港口国控制检查 |
get_vessel_casualties | 获取海上伤亡记录 |
get_vessel_inspection_detail | 获取特定检查的详细信息 |
get_vessel_positions_batch | 一次获取多艘船的位置（可选时间范围） |
端口工具
| 工具 | 说明 |
|---|---|
search_ports | 按名称、国家、类型、大小、地区、港口大小或港口用途搜索港口 |
get_port | 通过UN/LOCODE获取端口详细信息 |
get_port_events | 获取港口的到达/出发信息 |
get_port_events_by_vessel | 获取船舶的港口事件 |
list_port_events | 使用时间、国家、港口、船只或事件类型的过滤器在全球范围内列出港口事件 |
search_port_events_by_port | 按端口名称搜索端口事件 |
search_port_events_by_vessel | 按船名搜索港口事件 |
get_vessel_last_port_event | 获取船舶的最新港口事件 |
排放工具
| 工具 | 说明 |
|---|---|
list_emissions | 使用可选的年份过滤器列出全球船舶排放数据 |
定位工具
| 工具 | 说明 |
|---|---|
get_vessels_in_area | 在边界框中查找血管（可选时间范围） |
get_vessels_in_radius | 查找点半径内的船只（可选时间范围） |
安全工具
| 工具 | 说明 |
|---|---|
get_navtex_messages | 获取NAVTEX海上安全信息 |
分页
所有列表端点支持 limit 和 nextToken 手动分页的参数。当存在更多结果时，响应包括 nextToken --在下次调用时传递它以获取下一页。
发展
git clone https://github.com/vessel-api/vesselapi-mcp.git
cd vesselapi-mcp
npm install
npm run buildnpm run build # Build the server
npm run typecheck # Type-check without emitting
npm run clean # Remove build artifactsMCP检验员测试
VESSELAPI_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js许可证
麻省理工学院
