MCP Shipxy Api

🚀 shipxy-api-mcp

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

🚀 快速开始

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"
      }
    }
  }
}

✨ 主要特性

• 全面支持 MCP 协议：可与任何符合 MCP 协议的智能体、大语言模型或平台无缝集成。
• 丰富的海事数据：涵盖船舶、港口、航线、天气、潮汐等多方面数据。
• 实时与历史数据：提供实时船舶跟踪、航行历史和事件记录。
• 开源且可扩展：采用 MIT 许可证，易于定制和扩展。

💻 使用示例

基础用法

以下是使用 search_ship API 进行船舶模糊搜索的示例：

# 这里可以添加调用 search_ship API 的示例代码
# 假设使用 Python 的 requests 库
import requests

api_key = "your_api_key"
url = f"https://api.shipxy.com/v3/search_ship?api_key={api_key}&keyword=your_search_keyword"
response = requests.get(url)
print(response.json())

高级用法

以下是使用 plan_route_by_point API 进行两点间航线规划的示例：

# 高级场景说明：根据给定的两个坐标点，规划船舶航线
import requests

api_key = "your_api_key"
start_point = "120.0,30.0"
end_point = "121.0,31.0"
url = f"https://api.shipxy.com/v3/plan_route_by_point?api_key={api_key}&start={start_point}&end={end_point}"
response = requests.get(url)
print(response.json())

📚 详细文档

支持的 API

🌍 应用场景

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

🔧 技术细节

项目结构

.
├── 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