KMB Bus MCP Server

KMB 巴士 MCP 服务

一个模型上下文协议（MCP）服务，可实时获取香港九龍巴士（KMB）和龍運巴士（Long Win Bus）的路线信息和到站时间。该服务可让大语言模型查询香港巴士服务信息，从而回答用户有关巴士路线、站点和预计到站时间的问题。

功能

• 实时巴士到站信息（预计到站时间）
• 全面的巴士路线查询
• 巴士站信息与搜索
• 路线与站点映射
• 用于优化 API 调用的缓存系统
• 双语支持（英语和繁体中文）

数据来源

本项目使用 KMB/LWB 官方开放数据 API：

• 基础 URL：https://data.etabus.gov.hk/v1/transport/kmb
• KMB 开放数据 API 文档

先决条件

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

安装

通过 Smithery 安装

如需通过 Smithery 自动为 Claude Desktop 安装 KMB Bus MCP：

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. 此服务提供多种工具，供大语言模型查询巴士信息：

• 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：用于测试（仅开发环境）

贡献

欢迎贡献！请随时提交 Pull Request。

致谢

• 感谢 KMB/LWB 提供开放数据 API
• 感谢 MCP 协议开发者

注意

此服务依赖 KMB/LWB 开放数据 API。请留意 API 速率限制，并在生产环境中实施适当的错误处理。