九巴巴士MCP服务器

一个模型上下文协议 (MCP) 服务器，可实时访问香港九龙巴士 (KMB) 和龙运巴士 (Long Win Bus) 的路线信息和到达时间。该服务器支持语言模型查询香港公交服务信息，以解答用户关于公交路线、站点和预计到达时间的问题。

特征

• 实时公交车到站信息（ETA）

• 综合公交线路查询

• 公交车站信息和搜索

• 路线站点映射

• 缓存系统优化 API 调用

• 双语支持（英语和繁体中文）

Related MCP server: mcp-flight-search

数据源

该项目利用 KMB/LWB 官方开放数据 API：

• 基本网址： 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 #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 请求。

致谢

• 九巴/龙运巴士提供开放数据API

• MCP 协议开发者

笔记

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