HK Bus MCP Server

An MCP (Model Context Protocol) server that provides real-time Hong Kong public transport ETA information. It wraps the hk-bus-eta npm package, which aggregates data from DATA.GOV.HK and various transport providers.

Supported Transport

• KMB / Long Win Bus (KMB)

• Citybus (CTB)

• New Lantao Bus (NLB)

• Green Minibus (GMB)

• MTR Light Rail Feeder Bus (lrtfeeder)

• MTR Light Rail (lightRail)

• MTR Heavy Rail (mtr)

• Ferries (Sun Ferry, Fortune Ferry, HKKF)

Related MCP server: Hong Kong Transportation MCP Server

Tools

Setup

Install & Build

npm install
npm run build

Configure with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hk-bus": {
      "command": "node",
      "args": ["/path/to/hk-bus-mcp/dist/index.js"]
    }
  }
}

Configure with Cursor / Windsurf

Add to your MCP settings:

{
  "mcpServers": {
    "hk-bus": {
      "command": "node",
      "args": ["/path/to/hk-bus-mcp/dist/index.js"]
    }
  }
}

Usage Examples

Once connected, you can ask the AI things like:

• "When is the next bus 968 from Causeway Bay?"

• "Show me all stops for bus route A21"

• "Find buses going to Tsim Sha Tsui"

• "What's the ETA for KMB route 1 at Star Ferry stop?"

• "List all routes for Citybus"

The AI will use the MCP tools to search routes, find stops, and fetch real-time ETAs.

Data Sources

• Route/stop/fare data: data.hkbus.app (daily synced from hk-bus-crawling)

• KMB ETA: data.etabus.gov.hk

• CTB ETA: rt.data.gov.hk

• MTR ETA: rt.data.gov.hk

• NLB ETA: rt.data.gov.hk

• GMB ETA: data.hkbus.app

License

GPL-3.0-only (same as hk-bus-eta)