MarineTraffic MCP Server

MarineTraffic MCP Server

site icon
2025.05.08 0
TypeScript船舶跟踪海上交通管理物流管理海事安全位置服务
MarineTraffic MCP Server 是一个基于模型上下文协议(MCP)的服务,提供对 MarineTraffic 船舶跟踪数据的访问。该服务能够获取船舶的实时位置、详细信息,支持按名称、MMSI、IMO 或船舶类型搜索船舶,以及获取指定地理区域内的船舶列表。
View on GitHub

Overview

基本能力

产品定位

MarineTraffic MCP Server 是一个专门用于访问和查询 MarineTraffic 船舶跟踪数据的服务,适用于需要实时或近实时船舶信息的应用场景。

核心功能

  • get_vessel_position: 通过 MMSI 或 IMO 号码获取船舶的实时位置
  • get_vessel_details: 通过 MMSI 或 IMO 号码获取船舶的详细信息
  • search_vessels: 按名称、MMSI、IMO 或船舶类型搜索船舶
  • get_vessels_in_area: 获取指定地理区域内的船舶列表

适用场景

  • 船舶跟踪与监控
  • 海上交通管理
  • 物流与供应链管理
  • 海事安全与救援

工具列表

  • get_vessel_position: 获取船舶实时位置
  • get_vessel_details: 获取船舶详细信息
  • search_vessels: 搜索船舶
  • get_vessels_in_area: 获取区域内的船舶列表

常见问题解答

  • API Key Errors: 确保 MarineTraffic API 密钥有效并正确设置
  • Rate Limiting: 遇到速率限制错误时,服务器会自动重试,但可能需要等待
  • No Data Found: 某些船舶可能没有实时跟踪数据,特别是在 AIS 覆盖有限的区域

使用教程

使用依赖

安装教程

  1. 克隆仓库或下载源代码
  2. 安装依赖:
cd marinetraffic-server
npm install
  1. 构建服务器:
npm run build

调试方式

确保 MarineTraffic API 密钥已通过环境变量 MARINETRAFFIC_API_KEY 提供。

配置 MCP 设置文件以与 Claude 一起使用,具体配置方法见 README。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。