MCP Server de Consulta de Billetes de Tren (FastMCP)

Servicio de consulta de billetes de tren / trenes de alta velocidad implementado con FastMCP, que puede ser invocado por cualquier agente (como deepagents, LangGraph, Claude, etc.) como herramienta MCP remota.

Capacidades

Una función de herramienta: query_train_tickets(from_station, to_station, date)

• Consulta los trenes, horarios, duración, estado de reserva y disponibilidad de billetes entre dos estaciones en un día determinado.

• Fuente de datos: la interfaz pública de consulta de 12306 (datos reales); cuando la interfaz está bloqueada por control de riesgos, cambia automáticamente a datos simulados e indica claramente la fuente, garantizando que el flujo se pueda demostrar en cualquier momento.

Related MCP server: THSRC MCP Server

Ejecución local

pip install -r requirements.txt
python server.py        # 启动 streamable-http 服务，默认 http://127.0.0.1:8000

Configuración del cliente MCP (depuración local):

{
  "mcpServers": {
    "train": {
      "url": "http://127.0.0.1:8000/mcp/",
      "transport": "streamable_http"
    }
  }
}

Implementación en la Plaza MCP de 魔搭 (pasos clave)

1. Sube este repositorio a GitHub.

2. Abre modelscope.cn/mcp e inicia sesión → haz clic en «Crear MCP».

3. En el tipo de creación, elige «Creación rápida desde GitHub»; en el tipo de alojamiento, elige «Implementación alojada».

4. Completa el nombre en inglés/chino, la dirección de origen (URL del repositorio de GitHub) y sigue las instrucciones de la plataforma para completar la configuración.

5. Después de enviarlo, la plataforma genera una dirección de acceso: https://mcp.api-inference.modelscope.net/<你的ID>/sse o /mcp (se puede configurar como válido a largo plazo).

6. Simplemente inserta esa dirección en la configuración MCP del proyecto del agente.

Nota: La plataforma tiene requisitos sobre la forma de iniciar el proyecto alojado (generalmente requiere Python + iniciar un servicio HTTP). Si el despliegue falla, ajusta el punto de entrada según las indicaciones de la plataforma (por ejemplo, proporcionando un script run o variables de entorno).

Explicación de las fuentes de datos

• 12306 no tiene una API oficial abierta; este proyecto utiliza su interfaz pública de consulta (kyfw.12306.cn/otn/leftTicket), consulta sin iniciar sesión, solo para estudio e investigación personal.

• La interfaz está sujeta a control de riesgos (302 esporádico); el código ya dispone de cookie de sesión + datos simulados como respaldo.

• Si necesitas datos más estables, puedes reemplazar _fetch_12306 por una fuente de datos de terceros (conectable).

Directorio

• server.py — programa principal del servicio FastMCP

• test_client.py — script de depuración local (llama directamente a las funciones de la herramienta + prueba a través del protocolo MCP)

• requirements.txt — dependencias