KMB Bus MCP Server

KMB Bus MCP サーバー

香港のKMB（九龍巴士）およびLong Win Bus（龍運巴士）の路線情報と到着時刻にリアルタイムでアクセスできる、Model Context Protocol（MCP）サーバーです。このサーバーを利用すると、LLMは香港のバスサービス情報を照会し、バス路線、停留所、到着予定時刻に関するユーザーの質問に回答できます。

機能

• バスの到着情報をリアルタイムで提供（ETA）
• バス路線を幅広く照会
• バス停の情報と検索
• 路線と停留所の対応付け
• API 呼び出しを最適化するキャッシュシステム
• バイリンガル対応（英語と繁体字中国語）

データソース

このプロジェクトは、公式のKMB/LWB Open Data APIを利用しています。

• ベース URL: https://data.etabus.gov.hk/v1/transport/kmb
• KMB Open Data API ドキュメント

前提条件

• Python 3.10 以上
• uv パッケージマネージャー

インストール

Smithery 経由でのインストール

Smithery 経由でKMB Bus MCPをClaude Desktopに自動インストールするには、次の手順を実行します。

npx -y @smithery/cli install @kennyckk/mcp_hkbus --client claude

手動インストール

1. まず、まだインストールしていない場合はuvをインストールします。

curl -LsSf https://astral.sh/uv/install.sh | sh

2. リポジトリをクローンします。

git clone [email protected]:kennyckk/mcp_hkbus.git
cd mcp_hkbus

3. uvを使ってPythonパッケージを管理します。

uv sync #using uv.lock

使用方法

1. MCP クライアント（例：Claude Desktop）の設定を編集します。

{
  "mcpServers": {
    "bus_service": {
      "command": "path/to/uv.exe",
      "args": ["--directory", "path/to/kmb_bus", "run", "kmb_mcp.py"],
      "background": true
    }
  }
}

2. サーバーは、LLMがバス情報を照会するために使用できる複数のツールを提供します。

• get_route_list(): すべてのバス路線の一覧を取得
• get_stop_list(): すべてのバス停の一覧を取得
• get_route_stops(): 指定した路線の停留所を取得
• find_stops_by_name(): 名前でバス停を検索
• get_all_routes_at_stop(): 指定した停留所に停車するすべての路線を取得
• get_eta(): 到着予定時刻を取得

テスト

pytestを使ってテストスイートを実行します。

pytest test/kmb-mcp-tests.py

依存関係

• httpx: 非同期HTTPリクエスト用
• fastmcp: MCP サーバーの実装用
• pytest: テスト用（開発時のみ）

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

謝辞

• オープンデータ API を提供しているKMB/LWB
• MCP プロトコルの開発者

注意

このサービスはKMB/LWB Open Data APIに依存しています。API のレート制限に留意し、本番環境では適切なエラーハンドリングを実装してください。