Summary
Connects Claude to Hong Kong's KMB and Long Win Bus open data API to query real time bus arrivals and route information. Exposes six tools including get_route_list for browsing all routes, find_stops_by_name for searching stops, get_route_stops for mapping routes to stops, and get_eta for estimated arrival times. Built with fastmcp and includes a caching layer to reduce API calls. Responses come in both English and Traditional Chinese. Reach for this when building transit assistants for Hong Kong or adding local bus information to Hong Kong focused applications. Uses the official data.etabus.gov.hk API with Python 3.10+ and uv package manager.
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
KMB Bus MCP Server
A Model Context Protocol (MCP) server that provides real-time access to Hong Kong's KMB (九龍巴士) and Long Win Bus (龍運巴士) route information and arrival times. This server enables Language Models to query Hong Kong bus service information to answer user questions about bus routes, stops, and estimated arrival times.
Features
- Real-time bus arrival information (ETA)
- Comprehensive bus route queries
- Bus stop information and searches
- Route-stop mapping
- Caching system to optimize API calls
- Bilingual support (English and Traditional Chinese)
Data Source
This project utilizes the official KMB/LWB Open Data API:
Prerequisites
- Python 3.10 or higher
- uv package manager
Installation
Installing via Smithery
To install KMB Bus MCP for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @kennyckk/mcp_hkbus --client claude
Manual Installation
- First, install uv if you haven't already:
curl -LsSf https://astral.sh/uv/install.sh | sh
- Clone the repository:
git clone git@github.com:kennyckk/mcp_hkbus.git
cd mcp_hkbus
- Use uv to handle the python package:
uv sync #using uv.lock
Usage
- Edit the Config in your MCP Client (e.g. Claude Desktop):
{
"mcpServers": {
"bus_service": {
"command": "path/to/uv.exe",
"args": ["--directory", "path/to/kmb_bus", "run", "kmb_mcp.py"],
"background": true
}
}
}
- The server provides several tools that can be used by Language Models to query bus information:
get_route_list(): Get a list of all bus routesget_stop_list(): Get a list of all bus stopsget_route_stops(): Get stops for a specific routefind_stops_by_name(): Search for bus stops by nameget_all_routes_at_stop(): Get all routes serving a specific stopget_eta(): Get estimated arrival times
Testing
Run the test suite using pytest:
pytest test/kmb-mcp-tests.py
Dependencies
httpx: For async HTTP requestsfastmcp: For MCP server implementationpytest: For testing (development only)
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Acknowledgments
- KMB/LWB for providing the open data API
- The MCP protocol developers
Note
This service relies on the KMB/LWB Open Data API. Please be mindful of API rate limits and implement appropriate error handling in production environments.
Featured
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Give your AI agent a complete email layer—sending, inbound inboxes, and sandbox testing.
Get 4K emails/month free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →