Skip to main content
Glama
KMB Bus MCP Server

KMB Bus MCP Server

by kennyckk

Servidor MCP de bus KMB

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso en tiempo real a la información de rutas y horarios de llegada de los autobuses KMB (九龍巴士) y Long Win (龍運巴士) de Hong Kong. Este servidor permite a los Modelos de Lenguaje consultar la información del servicio de autobuses de Hong Kong para responder a las preguntas de los usuarios sobre rutas, paradas y horarios de llegada estimados.

Características

  • Información de llegada de autobuses en tiempo real (ETA)

  • Consultas completas de rutas de autobús

  • Información y búsquedas de paradas de autobús

  • Mapeo de rutas y paradas

  • Sistema de almacenamiento en caché para optimizar las llamadas API

  • Soporte bilingüe (inglés y chino tradicional)

Related MCP server: Hong Kong Transportation MCP Server

Fuente de datos

Este proyecto utiliza la API oficial de datos abiertos KMB/LWB:

Prerrequisitos

  • Python 3.10 o superior

  • administrador de paquetes uv

Instalación

  1. Primero, instala uv si aún no lo has hecho:

curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Clonar el repositorio:

git clone git@github.com:kennyckk/mcp_hkbus.git
cd mcp_hkbus
  1. Utilice uv para manejar el paquete de Python:

uv sync #using uv.lock

Uso

  1. Edite la configuración en su cliente MCP (por ejemplo, Claude Desktop):

{
  "mcpServers": {
    "bus_service": {
      "command": "path/to/uv.exe",
      "args": ["--directory", "path/to/kmb_bus", "run", "kmb_mcp.py"],
      "background": true
    }
  }
}
  1. El servidor proporciona varias herramientas que los modelos de lenguaje pueden utilizar para consultar información del bus:

  • get_route_list() : obtiene una lista de todas las rutas de autobús

  • get_stop_list() : Obtener una lista de todas las paradas de autobús

  • get_route_stops() : Obtener paradas para una ruta específica

  • find_stops_by_name() : busca paradas de autobús por nombre

  • get_all_routes_at_stop() : Obtener todas las rutas que sirven a una parada específica

  • get_eta() : Obtener los tiempos de llegada estimados

Pruebas

Ejecute el conjunto de pruebas usando pytest:

pytest test/kmb-mcp-tests.py

Dependencias

  • httpx : para solicitudes HTTP asíncronas

  • fastmcp : Para la implementación del servidor MCP

  • pytest : para pruebas (solo desarrollo)

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Expresiones de gratitud

  • KMB/LWB por proporcionar la API de datos abiertos

  • Los desarrolladores del protocolo MCP

Nota

Este servicio se basa en la API de datos abiertos KMB/LWB. Tenga en cuenta los límites de velocidad de la API e implemente un manejo de errores adecuado en entornos de producción.

Available Tools

5 tools
find_buses_to_destinationB

Find bus routes that go to a specified destination.

Args:
    destination: The destination to search for (e.g., "Central", "Mong Kok", "Airport")

Inputs: destination (required). Returns: result

find_stop_by_nameA

Find bus stops matching a name or partial name.

Args:
    stop_name: Full or partial name of the bus stop to search for

Inputs: stop_name (required). Returns: result

get_all_routes_at_stopB

Get all bus routes that pass through a specified bus stop.

Args:
    stop_name: Name of the bus stop

Inputs: stop_name (required). Returns: result

get_next_busB

Get the next arrival time for a specified bus route at a stop.

Args:
    route: The bus route number (e.g., "1A", "6", "960")
    stop_name: The name of the bus stop

Inputs: route (required), stop_name (required). Returns: result

get_route_stops_infoB

Get all stops along a specified bus route.

Args:
    route: The bus route number (e.g., "1A", "6", "960")

Inputs: route (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: finding buses to destinations, searching stops by name, getting routes at a stop, checking next bus arrivals, and listing stops on a route. The descriptions reinforce these unique functions, making misselection unlikely.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with underscores (e.g., find_buses_to_destination, get_route_stops_info). The naming is uniform and predictable, using clear action verbs like 'find' and 'get' paired with descriptive nouns.

    Tool Count5/5

    With 5 tools, this server is well-scoped for a bus information system. Each tool serves a specific, necessary function in querying routes, stops, and schedules, avoiding bloat while covering core use cases effectively.

    Completeness4/5

    The tool set covers essential bus information queries: route discovery, stop lookup, schedule checking, and route details. A minor gap exists in lacking tools for broader operations like route planning or real-time updates, but agents can work around this with the provided tools.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches