KMBバスMCPサーバー

香港のKMB（九龍巴士）とLong Win Bus（龍運巴士）の路線情報と到着時刻にリアルタイムでアクセスできるモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、言語モデルは香港のバスサービス情報を照会し、バスの路線、停留所、到着予定時刻に関するユーザーの質問に答えることができます。

特徴

• リアルタイムのバス到着情報（ETA）

• 包括的なバス路線検索

• バス停情報と検索

• ルート停留所マッピング

• API呼び出しを最適化するキャッシュシステム

• バイリンガルサポート（英語と中国語（繁体字））

Related MCP server: mcp-flight-search

データソース

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

• ベース URL: https://data.etabus.gov.hk/v1/transport/kmb

• KMBオープンデータAPIドキュメント

前提条件

• Python 3.10以上

• UVパッケージマネージャー

インストール

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

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

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

使用法

1. MCP クライアント (例: Claude Desktop) で構成を編集します。

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

• get_route_list() : すべてのバス路線のリストを取得する

• get_stop_list() : すべてのバス停のリストを取得する

• get_route_stops() : 特定のルートの停留所を取得する

• find_stops_by_name() : バス停を名前で検索する

• get_all_routes_at_stop() : 特定の停留所を通るすべてのルートを取得する

• get_eta() : 到着予定時刻を取得する

テスト

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

依存関係

• httpx : 非同期HTTPリクエスト用

• fastmcp : MCPサーバーの実装用

• pytest : テスト用（開発のみ）

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

謝辞

• オープンデータAPIを提供するKMB/LWB

• MCPプロトコル開発者

注記

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