Searoute

searoute_mcp

目次

• 概要
• インストール
• クイックスタート
• 主なツール
• プロンプトの例
• サーバーの実行
• コントリビューション
• ライセンス
• 参考資料

---

概要

searoute_mcp は、海上ルート検索用の Model Context Protocol (MCP) サーバーです。
searoute-py を MCP と統合し、LLM クライアント（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 2 つの座標間の最短外洋ルート距離（海里）を計算します。

• 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 ファイルを参照してください。

---

参考資料

searoute_mcp は、海上ルート検索とネットワーク分析に関する、先行するオープンソースプロジェクトおよび研究プロジェクトを基盤としています。

• Marnet Project — 大西洋地域の海洋社会経済指標アトラス 北部・西部地域議会が主導する EU の国際共同プロジェクトです。大西洋地域向けの社会経済データネットワークを開発しています。

• searoute-py 2 点間の最短海上ルートを生成する Python パッケージです。現実的な海上ルートの可視化を目的としており、港やネットワークをカスタマイズできます。

• NetworkX 複雑なネットワークの作成、操作、研究を行うための Python パッケージです。ルート検索ロジックを支えるグラフアルゴリズムを提供します。

• Eurostat SeaRoute Eurostat による Java ベースのライブラリおよびウェブサービスです。AIS データで拡充された世界の海運ネットワークから、GeoTools を使用した Dijkstra アルゴリズムにより最短の海上ルートを計算します。