# KMB Bus

KMB Bus — an MCP server for querying KMB and Long Win Bus routes and real-time arrival times in Hong Kong. Supports English and Traditional Chinese — useful when your agent answers questions about schedules and bus routes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 2125 installs · ★ 4 repo stars
- Author: kennyckk
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kennyckk/mcp_hkbus
- Updated: 2025-08-29
- Security check: automated, 2026-11-16 (text) — warning: a command downloads a script from astral.sh and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/mcp/kmb-bus

## What it does

The server connects models to the official KMB/LWB API through five tools: find next bus at a stop, search routes to a destination, get all stops on a route, search stops by name, and list all routes at a stop. Requests are cached to reduce API load.

Requires Python 3.10 and the uv package manager. Install on Claude Code in one command via Smithery, or on other platforms by adding the remote server URL `https://mcp_hkbus--kennyckk.run.tools` to your IDE config. The server relies on KMB/LWB open data — keep API rate limits in mind.

## Requirements
- Remote server: `https://mcp_hkbus--kennyckk.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-hkbus https://mcp_hkbus--kennyckk.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add kmb-bus --url https://mcp_hkbus--kennyckk.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kmb-bus": {
            "url": "https://mcp_hkbus--kennyckk.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kmb-bus": {
            "type": "http",
            "url": "https://mcp_hkbus--kennyckk.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http kmb-bus https://mcp_hkbus--kennyckk.run.tools
```

## When to use it
- find the next bus arrival time at a specific stop
- list all routes serving a destination
- show every stop along a route
- search for a bus stop by name
- find which routes pass through a stop

## Example prompts
- What buses go to Kowloon Railway Station?
- When is the next bus arriving at Central?
- Show me all routes passing through Causeway Bay

## Similar
- [Hong Kong Company Registry & Due Diligence (86hc.com)](https://affpapa.org/en/nevibecode/mcp/hong-kong-company-registry-due-diligence-86hccom.md) — MCP server · ★ 2 repo stars
- [rozklad-mcp](https://affpapa.org/en/nevibecode/mcp/rozklad-mcp.md) — MCP server · ★ 37 repo stars
- [PakBus](https://affpapa.org/en/nevibecode/mcp/pakbus.md) — MCP server
- [wsdot-mcp-server](https://affpapa.org/en/nevibecode/mcp/wsdot-mcp-server.md) — MCP server · 1120 installs
- [llm-bus](https://affpapa.org/en/nevibecode/mcp/llm-bus.md) — MCP server · ★ 9 repo stars
- [amazon-eventbridge-event-bus](https://affpapa.org/en/nevibecode/skills/amazon-eventbridge-event-bus.md) — skill · 1900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
