香港九龍巴士及龍運巴士 MCP 伺服器

一個提供香港九龍巴士（KMB）及龍運巴士（LWB）實時路線信息及到站時間的模型上下文协议（MCP）伺服器。此伺服器使語言模型能夠查詢香港巴士服務信息，以回答用戶關於車路、站點和 estimated arrival times 的問題。

功能

• 實時公交到站信息 (ETA)
• 全面的バス路線檢索
• 巴士站信息及搜索
• 路線至站點的映射
• 緓存系統以優化 API 調用
• 双語支持（英文和繁體中文）

数据源

此專案使用官方 KMB/LWB 開放數據 API：

• 基礎 URL: https://data.etabus.gov.hk/v1/transport/kmb
• KMB 開放數據 API 文件

依存條件

• Python 3.10 或更高版本
• uv 包管理器

安裝步驟

1. 首先安裝 uv（如果尚未安裝）：

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

2. 克隆Repositories：

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

3. 使用 uv 处理 python 包：

uv sync # 使用 uv.lock

使用方法

1. 編輯您的 MCP 客戶端（例如 Claude 桌面版）的 Config：

{
  "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(): 获取estimated arrival times

測試

使用 pytest運行測試套件：

pytest test/kmb-mcp-tests.py

依存項

• httpx: 用於 async HTTP 請求
• fastmcp: 用於 MCP 伺服器實現
• pytest: 用於測試（開發環境）

參與貢獻

歡迎任何人的參與！請隨意提交 Pull Request。

次特別鳴

• KMB/LWB 提供開放數據 API
• MCP 协議的developers

注意事項

本服務依賴於 KMB/LWB 開放數據 API。請注意 API 的速率限制，在生產環境中實施適當的錯誤處理。