shipxy-api-mcp

Shipxy MCP Server 是一个完全符合MCP标准的开源位置服务（LBS）解决方案，适用于海事场景。它为开发者和AI代理提供了全面的船舶和港口API及工具套件。它可以无缝集成实时船舶数据、航线规划、天气、潮汐等信息到您的应用程序中。

🚀 简介

Shipxy MCP Server 赋予您的应用程序、LLMs和代理高级的海事数据和地理空间智能，包括：

• 船舶信息与跟踪： 实时船舶位置、静态信息、船队和区域查询。
• 港口与泊位数据： 全球港口搜索、泊位/锚地/预计到达时间查询、港口访问记录。
• 航线规划： 点对点和港对港航线规划。
• 天气与潮汐： 海洋天气、台风和潮汐站数据。
• 丰富的海事API： 船舶注册、详细信息、接近事件等。

所有API都遵循MCP协议，可以从任何符合MCP标准的客户端、LLM或代理平台调用。

🛠️ 主要功能

• 完整的MCP协议支持： 与任何符合MCP标准的代理、LLM或平台无缝集成。
• 全面的海事数据： 船舶、港口、航线、天气、潮汐等。
• 实时与历史数据： 实时船舶跟踪、航行历史和事件记录。
• 开源且可扩展： 使用MIT许可证，易于定制和扩展。

⚡ 快速开始

1. 获取您的API密钥

在Shipxy开放平台注册并创建服务器端API密钥。
注意： 所有请求都需要API密钥。

2. 安装

pip install -r requirements.txt

3. 配置

在项目根目录下创建一个.env文件：

SHIPXY_API_KEY=your_api_key_here

4. 启动服务器

推荐使用mcp.json配置文件以方便与MCP CLI和代理平台集成。示例：

{
  "mcpServers": {
    "shipxy-api-mcp": {
      "command": "python",
      "args": ["/path/to/your/server.py"],
      "env": {
        "SHIPXY_API_KEY": "your_api_key_here"
      }
    }
  }
}

🧩 支持的API

工具名称	描述
search_ship	模糊搜索船舶，可通过MMSI、IMO、名称或呼号进行搜索
get_single_ship	根据MMSI查询单个船舶的实时信息
get_many_ship	根据MMSI列表查询多个船舶的实时信息
get_fleet_ship	查询船队中的所有船舶
get_surrounding_ship	查询给定船舶周围10海里内的船舶
get_area_ship	查询指定区域内的船舶
get_ship_registry	查询船舶注册信息/国家信息
search_ship_particular	根据MMSI/IMO/呼号/名称查询船舶详细信息
search_port	模糊搜索港口，可通过名称或代码进行搜索
get_berth_ships	查询当前停靠在港口的船舶
get_anchor_ships	查询在港口抛锚的船舶
get_eta_ships	查询预计到达某个港口的船舶
get_ship_track	查询船舶的历史轨迹点
search_ship_approach	查询船舶之间的接近事件
get_port_of_call_by_ship	查询某艘船舶的港口访问记录
get_port_of_call_by_port	查询某个港口的访问记录
plan_route_by_point	规划两个坐标之间的航线
plan_route_by_port	规划两个港口之间的航线
get_single_eta_precise	获取船舶的ETA和航行信息
get_weather_by_point	根据坐标查询海洋天气
get_weather	根据区域查询海洋天气
get_all_typhoon	列出最近的台风
get_single_typhoon	查询特定台风的详细信息
get_tides	列出潮汐站
get_tide_data	查询某个潮汐站的数据

🌍 应用场景

• 海事物流与船队管理
• 船舶跟踪与监控
• 港口运营与ETA预测
• 智能航运与路线优化
• 海洋天气与安全应用

📦 项目结构

.
├── server.py           # MCP服务器入口点
├── ship_service.py     # Shipxy API集成和业务逻辑
├── requirements.txt    # Python依赖项
├── pyproject.toml      # 项目元数据
└── README.md           # 本文件

📄 许可证

MIT © shipxy-api-mcp贡献者

📞 联系方式

如需更多信息或商业咨询，请联系：

电话： 400-010-8558 / 010-8286 8599