KMB Bus MCP Server
KMBバスMCPサーバー
香港のKMB(九龍巴士)とLong Win Bus(龍運巴士)の路線情報と到着時刻にリアルタイムでアクセスできるモデルコンテキストプロトコル(MCP)サーバー。このサーバーにより、言語モデルは香港のバスサービス情報を照会し、バスの路線、停留所、到着予定時刻に関するユーザーの質問に答えることができます。
特徴
リアルタイムのバス到着情報(ETA)
包括的なバス路線検索
バス停情報と検索
ルート停留所マッピング
API呼び出しを最適化するキャッシュシステム
バイリンガルサポート(英語と中国語(繁体字))
Related MCP server: Hong Kong Transportation MCP Server
データソース
このプロジェクトでは、公式の KMB/LWB オープン データ API を利用しています。
前提条件
Python 3.10以上
UVパッケージマネージャー
インストール
まず、まだインストールしていない場合は uv をインストールします。
curl -LsSf https://astral.sh/uv/install.sh | shリポジトリをクローンします。
git clone git@github.com:kennyckk/mcp_hkbus.git
cd mcp_hkbusuv を使用して Python パッケージを処理します。
uv sync #using uv.lock使用法
MCP クライアント (例: Claude Desktop) で構成を編集します。
{
"mcpServers": {
"bus_service": {
"command": "path/to/uv.exe",
"args": ["--directory", "path/to/kmb_bus", "run", "kmb_mcp.py"],
"background": true
}
}
}サーバーは、言語モデルがバス情報を照会するために使用できるいくつかのツールを提供します。
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のレート制限に留意し、本番環境では適切なエラー処理を実装してください。
Available Tools
5 toolsfind_buses_to_destinationB
Find bus routes that go to a specified destination.
Args:
destination: The destination to search for (e.g., "Central", "Mong Kok", "Airport")
Inputs: destination (required). Returns: result
find_stop_by_nameA
Find bus stops matching a name or partial name.
Args:
stop_name: Full or partial name of the bus stop to search for
Inputs: stop_name (required). Returns: result
get_all_routes_at_stopB
Get all bus routes that pass through a specified bus stop.
Args:
stop_name: Name of the bus stop
Inputs: stop_name (required). Returns: result
get_next_busB
Get the next arrival time for a specified bus route at a stop.
Args:
route: The bus route number (e.g., "1A", "6", "960")
stop_name: The name of the bus stop
Inputs: route (required), stop_name (required). Returns: result
get_route_stops_infoB
Get all stops along a specified bus route.
Args:
route: The bus route number (e.g., "1A", "6", "960")
Inputs: route (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose with no overlap: finding buses to destinations, searching stops by name, getting routes at a stop, checking next bus arrivals, and listing stops on a route. The descriptions reinforce these unique functions, making misselection unlikely.
All tools follow a consistent verb_noun pattern with underscores (e.g., find_buses_to_destination, get_route_stops_info). The naming is uniform and predictable, using clear action verbs like 'find' and 'get' paired with descriptive nouns.
With 5 tools, this server is well-scoped for a bus information system. Each tool serves a specific, necessary function in querying routes, stops, and schedules, avoiding bloat while covering core use cases effectively.
The tool set covers essential bus information queries: route discovery, stop lookup, schedule checking, and route details. A minor gap exists in lacking tools for broader operations like route planning or real-time updates, but agents can work around this with the provided tools.
Maintenance
Related MCP Connectors
The official Model Context Protocol server for Ambee. It gives any MCP-compatible AI assistant — Claude, ChatGPT, Cursor, VS Code, Ollama, and more direct access to live air quality, pollen, and weather data. To get started, including information on signing up and obtaining your Ambee key, check out the Ambee documentation on https://docs.ambeedata.com
A Model Context Protocol server for Wix AI tools
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
The Ferryhopper MCP server is a connector for LLMs and AI Agents in maritime travel that exposes ferry routes, schedules, and booking options. It enables AI assistants to search ports and connections across 33 countries and 190+ ferry operators, provide real-time ferry itineraries with indicative prices, and assist users with planning island-hopping or multi-leg journeys by processing natural language queries about ferry times, passenger counts, and travel durations.
Related MCP Servers
- FlicenseBqualityDmaintenanceEnables Large Language Models to access real-time data on Vilnius public transport stops and routes through the Model Context Protocol.21-
- AlicenseNot gradedqualityCmaintenanceAn MCP server providing access to Hong Kong transportation data, including passenger traffic statistics at control points and real-time bus arrival information for KMB and Long Win Bus services.68 PyPI5MIT
- AlicenseBqualityDmaintenanceMCP server that integrates with the transport12 API to provide tools for searching stops, routes, arrivals, and vehicle forecasts, enabling natural language interaction with public transport data.1711 npmMIT
- FlicenseNot gradedqualityCmaintenanceAn MCP server that provides real-time Hong Kong public transport ETA information.-