KMB 巴士 MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供对香港九龙巴士 (KMB) 和龙运巴士路线信息和预计到达时间的实时访问。该服务器使语言模型能够查询香港巴士服务信息，以回答用户关于巴士路线、站点和预计到达时间的问题。

功能

• 实时巴士到达信息 (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. 克隆存储库：

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

3. 使用 uv 来处理 python 包：

uv sync #使用 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 速率限制，并在生产环境中实施适当的错误处理。