Searoute

searoute_mcp

目录

• 概述
• 安装
• 快速开始
• 核心工具
• 示例提示词
• 运行服务
• 参与贡献
• 许可证
• 参考资料

---

概述

searoute_mcp 是一个用于海上航线规划的 Model Context Protocol (MCP) 服务。
它将 searoute-py 与 MCP 集成，提供工具，让大模型客户端（例如 Claude Desktop）能够：

• 计算远洋航线距离（海里）
• 获取包含航路点的完整远洋航线（GeoJSON 格式）
• 与测地线大圆距离进行比较

为方便用户，所有工具都接受纬度、经度作为输入，并在内部将其转换为所需的 searoute 格式。

---

安装

克隆代码库并安装依赖项：

git clone https://github.com/ShippingIntel/searoute_mcp.git
cd searoute_mcp
python3 -m venv .venv
source .venv/bin/activate   # Linux/macOS
.venv\Scripts\activate      # Windows

pip install -r requirements.txt

依赖项：

• mcp[python]>=0.1.0
• searoute>=1.4.3
• geopy>=2.4.1

---

快速开始

在本地运行服务：

python -m mcp_server.main

安装到 Claude Desktop：

mcp install mcp_server/main.py

使用 MCP Inspector 测试：

mcp dev mcp_server/main.py

---

核心工具

• compute_distance 计算两个坐标之间最短的远洋航线距离（海里）。

• compute_route 获取完整的远洋航线（GeoJSON 几何信息 + 距离）。

• compute_geodesic 计算大圆（球面）距离，单位为海里，不考虑陆地和海洋的限制。

---

示例提示词

所有提示词均按纬度、经度的顺序排列。

{
  "tool": "compute_distance",
  "arguments": {
    "start_lat": 47.6062,
    "start_lon": -122.3321,
    "end_lat": 35.6895,
    "end_lon": 139.6917
  }
}

{
  "tool": "compute_route",
  "arguments": {
    "start_lat": 40.7128,
    "start_lon": -74.0060,
    "end_lat": 48.8566,
    "end_lon": 2.3522
  }
}

{
  "tool": "compute_geodesic",
  "arguments": {
    "start_lat": 51.5072,
    "start_lon": -0.1276,
    "end_lat": -33.8688,
    "end_lon": 151.2093
  }
}

示例：

• 西雅图 → 东京（远洋航线距离）
• 纽约 → 巴黎（包含航路点的完整航线）
• 伦敦 → 悉尼（测地线大圆距离）

---

运行服务

选择一种传输方式：

# stdio (local dev)
python -m mcp_server.main stdio

# Streamable HTTP (for deployment)
python -m mcp_server.main streamable-http

---

参与贡献

欢迎贡献！有关环境配置和工作流指南，请参阅 CONTRIBUTING.md。

---

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。

---

参考资料

searoute_mcp 基于此前在海上航线规划和网络分析方面的开源项目与研究成果：

• Marnet Project — 大西洋区域海洋社会经济指标图集 由北部和西部区域议会牵头的欧盟跨国项目，旨在为大西洋地区开发社会经济数据网络。

• searoute-py 用于生成两点间最短海上航线的 Python 软件包，专为可视化真实海上航线而设计，并支持使用港口和网络进行自定义。

• NetworkX 用于创建、操作和研究复杂网络的 Python 软件包，为航线规划逻辑提供底层图算法。

• Eurostat SeaRoute Eurostat 开发的 Java 库和 Web 服务，可根据经过 AIS 数据增强的全球航运网络，使用 GeoTools 通过 Dijkstra 算法计算最短海上航线。