MCP Hkbus

🚀 香港九龍巴士及龍運巴士 MCP サーバー

このサーバーは、香港九龍巴士（KMB）及び龍運巴士（LWB）のリアルタイム路線情報と到着予想時間を提供するモデルコンテキストプロトコル（MCP）サーバーです。言語モデルが香港のバスサービス情報を照会し、ユーザーの路線、停留所、estimated arrival timesに関する質問に回答できるようにします。

🚀 クイックスタート

このMCPサーバーを使用することで、言語モデルは香港のバスサービス情報を取得し、ユーザーの質問に回答できます。以下に、サーバーの機能、インストール方法、使用方法などを説明します。

✨ 主な機能

• リアルタイムのバス到着予想時間 (ETA)
• 全面的なバス路線検索
• バス停情報の提供と検索
• 路線と停留所のマッピング
• API呼び出しを最適化するキャッシュシステム
• 英語と繁體中文のバイリンガル対応

📦 インストール

依存条件

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

インストール手順

1. まず、uvをインストールします（未インストールの場合）。

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

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

git clone git@github.com:kennyckk/mcp_hkbus.git
cd mcp_hkbus

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

uv sync # uv.lockを使用

💻 使用例

基本的な使用法

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

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

2. サーバーは、言語モデルがバス情報を照会するためのいくつかのツールを提供します。

• get_route_list(): すべてのバス路線のリストを取得します。
• get_stop_list(): すべてのバス停のリストを取得します。
• get_route_stops(): 特定の路線の停留所を取得します。
• find_stops_by_name(): 名前でバス停を検索します。
• get_all_routes_at_stop(): 特定の停留所に停車するすべての路線を取得します。
• get_eta(): 到着予想時間を取得します。

📚 ドキュメント

データソース

このプロジェクトは、公式のKMB/LWBオープンデータAPIを使用しています。

• 基本URL: https://data.etabus.gov.hk/v1/transport/kmb
• KMBオープンデータAPIドキュメント

依存関係

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

テスト

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

pytest test/kmb-mcp-tests.py

貢献方法

誰でも貢献することができます！自由にPull Requestを送信してください。

謝辞

• KMB/LWBがオープンデータAPIを提供してくれたことに感謝します。
• MCPプロトコルの開発者の皆さんに感謝します。

注意事項

このサービスはKMB/LWBのオープンデータAPIに依存しています。APIのレート制限に注意し、本番環境では適切なエラー処理を実装してください。