Skip to main content
Glama
vessel-api

VesselAPI MCP Server

by vessel-api

VesselAPI MCP Server

CI npm Node License: MIT

一个 MCP (Model Context Protocol) 服务器,将 VesselAPI 的海事数据提供给 Claude Desktop、Cursor、Windsurf 和 Claude Code 等 AI 助手。

前提条件

  1. dashboard.vesselapi.com 注册

  2. 在您的仪表盘中创建 API 令牌

  3. 在下面的配置中使用该令牌作为 VESSELAPI_API_KEY

资源文档 | API Explorer | 仪表盘 | 联系支持

Related MCP server: @globalfishingwatch/gfw-mcp-js

功能特性

  • 19 个工具,涵盖船舶、港口、位置搜索和排放

  • 船舶搜索、位置(单个和批量)、ETA、排放和事故

  • 港口搜索、详情、港口事件(到达/离港)和全球港口事件搜索

  • 地理船舶搜索(边界框和半径)

  • 手动分页以控制 API 配额使用

托管部署

托管部署可在 Fronteir AI 上获取。

快速开始

无需安装。使用 npx 配置您的 AI 客户端:

{
  "mcpServers": {
    "vesselapi": {
      "command": "npx",
      "args": ["-y", "vesselapi-mcp"],
      "env": {
        "VESSELAPI_API_KEY": "your-api-key"
      }
    }
  }
}

配置

将上面的 JSON 添加到您客户端的配置文件中:

客户端

配置文件

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)

Cursor

.cursor/mcp.json~/.cursor/mcp.json

Claude Code

claude mcp add,会在项目中写入 .mcp.json,或在用户范围内写入 ~/.claude.json

Windsurf

~/.codeium/windsurf/mcp_config.json

工具

船舶工具

工具

描述

search_vessels

按名称、IMO、MMSI、船旗、类型、呼号或建造年份搜索船舶

get_vessel

获取详细的船舶信息

get_vessel_position

获取当前船舶位置(纬度/经度、速度、航向)

get_vessel_eta

获取船舶预计到达时间

get_vessel_emissions

获取排放数据(CO2、燃料消耗)

get_vessel_casualties

获取海上事故记录

get_vessel_positions_batch

一次获取多艘船舶的位置(可带可选时间范围)

港口工具

工具

描述

search_ports

按名称、国家、类型、规模、地区、港口大小或港口用途搜索港口

get_port

按 UN/LOCODE 获取港口详情

get_port_inbound

获取在 ETA 时间窗口内进港的船舶

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

查找某点半径范围内的船舶(可带可选时间范围)

分页

所有列表端点都支持 limitnextToken 参数,用于手动分页。当存在更多结果时,响应会包含 nextToken。在下次调用中传入它即可获取下一页。

开发

git clone https://github.com/vessel-api/vesselapi-mcp.git
cd vesselapi-mcp
npm install
npm run build
npm run build        # Build the server
npm run typecheck    # Type-check without emitting
npm run clean        # Remove build artifacts

使用 MCP Inspector 进行测试

VESSELAPI_API_KEY=your-key npx @modelcontextprotocol/inspector node dist/index.js

数据来源与署名

排放和事故数据:© 欧盟。来源:欧洲海事安全局 (EMSA):THETIS-MRV(欧盟 MRV,法规 (EU) 2015/757)和欧洲海上事故信息平台 (EMCIP)。根据欧盟委员会再利用通知(委员会决定 2011/833/EU)重复使用,该通知授权在注明来源的情况下用于商业和非商业目的。数据可能经过转换和合并;EMSA 不认可此服务。

许可证

MIT

Install Server
A
license - permissive license
B
quality
B
maintenance

Maintenance

Maintainers
Response time
4wRelease cycle
7Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vessel-api/vesselapi-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server