返回 MCP 目录
public公开dns本地运行

marinetraffic-mcp-server

一个基于MarineTraffic API的MCP服务器,提供船舶实时位置查询、详细信息获取、区域船舶搜索等功能。

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}:列出指定地理区域内的船只。

📦 安装指南

先决条件

设置

  1. 克隆此仓库或下载源代码。
  2. 安装依赖:
cd marinetraffic-server
npm install
  1. 构建服务器:
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 许可证发布。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端