Related MCP Server Resources

Explore more AI models, providers, and integration options:

  • Explore AI Models
  • Explore AI Providers
  • Explore MCP Servers
  • LangDB Pricing
  • Documentation
  • AI Industry Blog
  • A11y MCP Server
  • HeFeng Weather MCP Server
  • Notion Knowledge Base MCP Server
  • Image Processor MCP Server
  • MCP Server
Back to MCP Servers
KMB Bus MCP Server

KMB Bus MCP Server

Public
kennyckk/mcp_hkbus

Provides real-time access to Hong Kong KMB and Long Win bus routes, stops, and estimated arrival times via Model Context Protocol, supporting bilingual queries and optimized API usage.

python
0 tools
May 30, 2025
Updated Jun 4, 2025

Supercharge Your AI with KMB Bus MCP Server

MCP Server

Unlock the full potential of KMB Bus MCP Server through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.

Unified API Access
Complete Tracing
Instant Setup
Get Started Now

Free tier available • No credit card required

Instant Setup
99.9% Uptime
10,000+Monthly Requests

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:

  • Base URL: https://data.etabus.gov.hk/v1/transport/kmb
  • KMB Open Data API Documentation

Prerequisites

  • Python 3.10 or higher
  • uv package manager

Installation

  1. First, install uv if you haven't already:
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Clone the repository:
git clone git@github.com:kennyckk/mcp_hkbus.git cd mcp_hkbus
  1. Use uv to handle the python package:
uv sync #using uv.lock

Usage

  1. 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 } } }
  1. 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 routes
  • get_stop_list(): Get a list of all bus stops
  • get_route_stops(): Get stops for a specific route
  • find_stops_by_name(): Search for bus stops by name
  • get_all_routes_at_stop(): Get all routes serving a specific stop
  • get_eta(): Get estimated arrival times

Testing

Run the test suite using pytest:

pytest test/kmb-mcp-tests.py

Dependencies

  • httpx: For async HTTP requests
  • fastmcp: For MCP server implementation
  • pytest: 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.

Publicly Shared Threads0

Discover shared experiences

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!

Share your threads to help others
Related MCPs5
  • A11y MCP Server
    A11y MCP Server

    Provides Model Context Protocol access to web accessibility testing APIs for analyzing URLs and HTML...

    Added May 30, 2025
  • HeFeng Weather MCP Server
    HeFeng Weather MCP Server

    Provides real-time and extended weather forecasts for locations in China using Model Context Protoco...

    1 tools
    Added May 30, 2025
  • Notion Knowledge Base MCP Server
    Notion Knowledge Base MCP Server

    Provides seamless access to Notion knowledge bases via Model Context Protocol, enabling detailed, re...

    Added May 30, 2025
  • Image Processor MCP Server
    Image Processor MCP Server

    A TypeScript-based Model Context Protocol server enabling creation, access, and summarization of tex...

    2 tools
    Added May 30, 2025
  • MCP Server
    MCP Server

    Provides greeting-related tools, resources, and prompts via Model Context Protocol (MCP), enabling p...

    Added May 30, 2025