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)

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

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

curl -LsSf https://astral.sh/uv/install.sh | sh

Clonar el repositorio:

git clone git@github.com:kennyckk/mcp_hkbus.git
cd mcp_hkbus

Utilice uv para manejar el paquete de Python:

uv sync #using uv.lock

Uso

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
    }
  }
}

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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servidor de protocolo de contexto de modelo que brinda acceso en tiempo real a la información de las rutas de autobuses KMB y Long Win de Hong Kong y a los tiempos de llegada, lo que permite que los modelos de lenguaje respondan preguntas de los usuarios sobre rutas de autobuses, paradas y tiempos de llegada estimados.

Related MCP Servers

Vilnius Transport MCP Server
sarunasdaujotis
A
security
F
license
A
quality
Enables Large Language Models to access real-time data on Vilnius public transport stops and routes through the Model Context Protocol.
Last updated -
2
1
Python
NPM Sentinel MCP
Nekzus
A
security
A
license
A
quality
A Model Context Protocol server providing utility tools for development and testing, offering functionalities like personalized greetings, random card drawing, and datetime formatting with an extensible architecture.
Last updated -
19
215
2
TypeScript
MIT License
MCP TapData Serverofficial
tapdata
-
security
F
license
-
quality
A Model Context Protocol server that enables Large Language Models to access and interact with database connections, including viewing schemas and performing CRUD operations on connected databases.
Last updated -
MCP SSE Server
aihes
A
security
F
license
A
quality
An implementation of the Model Context Protocol (MCP) server using Server-Sent Events (SSE) for real-time communication, providing tools for calculations and dynamic resource templates.
Last updated -
1
JavaScript

View all related MCP servers

Appeared in Searches

Information on Cryptocurrency

KMB Bus MCP Server