MCP Server 12306

Name: MCP Server 12306
Author: drfccv

de drfccvversión 0.3.1i★ 423iSe ejecuta en tu computadora

Nombre en el registroio.github.drfccv/mcp-server-12306

Cómo instalar

What it does

An MCP server that provides 12306 ticket query

Connects Se ejecuta en tu computadora
Account or key No key needed
Category Otros

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

ClaudeWeb · app · móvilChatGPTWebClaude CodeTerminalCursorEditor de códigoVS CodeEditor de códigoOtrasOtras apps

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server MCP Server 12306 para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "12306": { "command": "uvx", "args": [ "mcp-server-12306" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP Server 12306 aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Hecho

Pega esta configuración y guarda el archivo

{
  "mcpServers": {
    "12306": {
      "command": "uvx",
      "args": [
        "mcp-server-12306"
      ]
    }
  }
}

Hecho

Cierra Claude y vuelve a abrirlo
Hecho
Pruébalo
Usa MCP Server 12306 y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude dice que está usando MCP Server 12306 o muestra una herramienta de MCP Server 12306 en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar MCP Server 12306

MCP Server 12306 se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar MCP Server 12306

Pasos para Claude →Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Pasos para Claude Code →Instala Python (uv) en tu computadora primero (una sola vez)
Pasos para Cursor →Instala Python (uv) en tu computadora primero (una sola vez)
Pasos para VS Code →Instala Python (uv) en tu computadora primero (una sola vez)

B · Otros en Otros que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Hostinger✓ ChatGPT
World Monitor✓ ChatGPT
Svelte MCP✓ ChatGPT

Funciona con Claude Code, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server MCP Server 12306 para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user 12306 -- uvx mcp-server-12306 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP Server 12306 aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Hecho

Pega este comando y pulsa Enter

claude mcp add --scope user 12306 -- uvx mcp-server-12306

Hecho

Escribe /mcp en Claude Code
Deberías ver MCP Server 12306 en la lista como conectado
Hecho
Pruébalo
Usa MCP Server 12306 y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude Code dice que está usando MCP Server 12306 o muestra una herramienta de MCP Server 12306 en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server MCP Server 12306 para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "12306": { "command": "uvx", "args": [ "mcp-server-12306" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP Server 12306 aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Pulsa este botón para abrir Cursor
Abrir en Cursor
Cursor te pedirá confirmar; pulsa Install
Hecho
Abre el chat de IA de Cursor en modo Agent
Hecho
Pruébalo
Usa MCP Server 12306 y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Cursor dice que está usando MCP Server 12306 o muestra una herramienta de MCP Server 12306 en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server MCP Server 12306 para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "12306": { "type": "stdio", "command": "uvx", "args": [ "mcp-server-12306" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP Server 12306 aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Pulsa este botón para abrir VS Code
Abrir en VS Code
VS Code te pedirá confirmar; pulsa Install
Hecho
Abre el chat de IA de VS Code en modo Agent
Hecho
Pruébalo
Usa MCP Server 12306 y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si VS Code dice que está usando MCP Server 12306 o muestra una herramienta de MCP Server 12306 en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa MCP Server 12306💬 Conversación →

Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user 12306 -- uvx mcp-server-12306

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "12306": {
      "command": "uvx",
      "args": [
        "mcp-server-12306"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "12306": {
      "command": "uvx",
      "args": [
        "mcp-server-12306"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "12306": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-12306"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Estrellas de GitHub i: 423
Descargas por semanai: 593/sem
Licencia i: MIT
Conexión: Se ejecuta en tu computadora
Transporte: stdio
Última versióni: 0.3.1
Categoríai: Otros
Publicado en el registroi: 9 feb 2026
Último cambio de códigoi: 5 nov 2026
Creador: drfccv
Paquetes: pypi: mcp-server-12306
Repo: drfccv/mcp-server-12306
Estado en el registro: Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 15 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub drfccv, dueña del repo
✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 10 días
✓ Superada
Tiene licencia
Usa MIT
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para mcp-server-12306@0.3.1

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo

Iniciar sesión

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Otrosi

Más estrellas que el 99% de los otros 19844 servidores de esta categoría
Publicado en el registro más recientemente que el 1% de los otros 19844 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 19844 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro MCP Server 12306?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 10 días, y la última versión (0.3.1) llegó al registro hace 9 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 97 tools.

de koala73Muy usado★ 90,6 milActualizado ayer

Se ejecuta en la nube✓ del servicio · worldmonitor.app

Cómo conectar

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

de openstatusHQMuy usado★ 9,3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · openstatus.dev

Cómo conectar

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

de JanDeDobbeleerMuy usado★ 23,8 mil Estrellas de todo el repositorioActualizado hace 26 días

Se ejecuta en la nube✓ del servicio · ohmyposh.dev

Cómo conectar

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

de Klavis-AIEn crecimiento★ 5,8 milActualizado hace 14 meses

Se ejecuta en la nubeRepo archivado✓ klavis.ai

Cómo conectar

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

de jitsucomMuy usado★ 5,1 milActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · jitsu.com

Cómo conectar

World Monitor — Funciona en la nube, sin instalar nada · Sin clave
openstatus — Funciona en la nube, sin instalar nada · Sin clave
Oh My Posh Validator — Funciona en la nube, sin instalar nada · Sin clave
Strata — Funciona en la nube, sin instalar nada · Sin clave
Jitsu — Funciona en la nube, sin instalar nada · Sin clave

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

🚄 MCP Server 12306

基于 Model Context Protocol (MCP) 的 12306 火车票查询服务

支持 余票 / 票价 / 车站 / 经停 / 换乘 / 时间 六大查询能力，开箱即用，适配 AI 助手、自动化脚本、智能终端等场景。

📑 目录

✨ 功能特性
🚀 快速开始
环境要求
方式一：Stdio 模式（本地客户端推荐）
方式二：Streamable HTTP 模式（远程部署）
方式三：Docker 部署
🛠️ 工具一览
⚙️ 配置项
🏗️ 项目结构
🧑💻 开发指南
📚 详细文档
⚠️ 免责声明
📄 License

✨ 功能特性

类别	能力
🎫 余票查询	余票 / 车次 / 座席 / 时刻一站式查询，支持按车次过滤
💰 票价查询	实时查询各车次各席别票价（商务座 → 无座全覆盖）
🏙️ 车站搜索	全国 3382+ 车站，支持中文 / 拼音 / 简拼 / 三字码模糊搜索
🔄 中转换乘	官方换乘方案自动分页抓取，返回完整路径与等待时间
🛤️ 经停查询	查询指定列车全部经停站与到发时刻
🕐 时间工具	获取任意时区当前时间、相对日期计算，辅助选择出行日期
🔌 双传输模式	Stdio（本地）\	Streamable HTTP（远程），同一核心实例共享
🔄 协议自动协商	基于 MCP SDK v2，自动兼容握手时代（2025-11-25）与现代协议（2026-07-28）

🚀 快速开始

环境要求

依赖	要求
Python	`>= 3.10, < 3.14`
包管理器	`uv`（推荐）或 `pip` / `pipx`
网络	可访问 12306 官方接口

💡 推荐使用 uv：环境隔离、安装快、锁文件管理依赖版本。

方式一：Stdio 模式（本地客户端推荐）

MCP Server 通过标准输入/输出与客户端通信，不占用网络端口，适合 Claude Desktop、Cursor 等本地 MCP 客户端。

安装：

# uvx（推荐，环境隔离）

uvx mcp-server-12306

或 pip / pipx

pip install mcp-server-12306

客户端配置（如 claude_desktop_config.json）：

"mcpServers": { "12306": { "command": "uvx", "args": ["mcp-server-12306"] } } }

其他安装方式（点击展开）

pipx：

"mcpServers": { "12306": { "command": "pipx", "args": ["run", "--no-cache", "mcp-server-12306"] } } }

本地源码（开发者调试）：

git clone https://github.com/drfccv/mcp-server-12306.git

cd mcp-server-12306 uv sync

"mcpServers": { "12306": { "command": "uv", "args": ["--directory", "/path/to/mcp-server-12306", "run", "mcp-server-12306"] } } }

方式二：Streamable HTTP 模式（远程部署）

Server 启动 Web 服务（默认 8000 端口），通过 MCP Streamable HTTP 协议通信：POST 发送 JSON-RPC、GET 订阅流式响应、DELETE 结束会话。

启动：

# 安装后直接启动

mcp-12306

或本地源码启动

uv run python scripts/start_server.py

客户端配置：

"mcpServers": { "12306": { "url": "http://localhost:8000/mcp" } } }

内置 HTTP 端点：

端点	方法	说明
`/mcp`	POST / GET / DELETE	MCP Streamable HTTP 协议入口
`/health`	GET	健康检查（含已加载车站数、活跃会话数）
`/schema/tools`	GET	全部工具 JSON Schema
`/`	GET	服务信息（版本、协议版本、端点）

方式三：Docker 部署

# 拉取镜像并运行（默认端口 8000）

docker run -d -p 8000:8000 --name mcp-server-12306 drfccv/mcp-server-12306:latest

自定义端口

docker run -d -p 8080:8000 \ -e SERVER_HOST=0.0.0.0 \ -e SERVER_PORT=8000 \ --name mcp-server-12306 \ drfccv/mcp-server-12306:latest

🛠️ 工具一览

工具名	功能	必填参数
`query-tickets`	余票 / 车次 / 座席 / 时刻一站式查询	`from_station`、`to_station`、`train_date`
`query-ticket-price`	实时查询车次票价	`from_station`、`to_station`、`train_date`
`search-stations`	车站模糊搜索（中文 / 拼音 / 简拼 / 三字码）	`query`
`query-transfer`	中转换乘方案查询	`from_station`、`to_station`、`train_date`
`get-train-route-stations`	查询列车经停站及时刻表	`train_no`、`from_station`、`to_station`、`train_date`
`get-train-no-by-train-code`	车次号 → 官方唯一编号	`train_code`、`from_station`、`to_station`、`train_date`
`get-current-time`	当前时间与相对日期（辅助选日期）	无

📖 每个工具的参数说明、返回示例、调用示例详见 📚 详细文档。

⚙️ 配置项

通过环境变量或项目根目录 .env 文件配置：

环境变量	默认值	说明
`SERVER_HOST`	`0.0.0.0`	HTTP 监听地址
`SERVER_PORT`	`8000`	HTTP 监听端口
`DEBUG`	`false`	调试模式
`LOG_LEVEL`	`INFO`	日志级别（`DEBUG` / `INFO` / `WARNING` / `ERROR`）

# 示例：.env

SERVER_HOST=127.0.0.1 SERVER_PORT=8000 LOG_LEVEL=INFO

🏗️ 项目结构

mcp-server-12306/

├── src/mcp_12306/ # 主包 │ ├── server.py # 核心 Server（工具注册与分发，双传输共享） │ ├── stdio_server.py # Stdio 传输层 + CLI 入口 │ ├── http_server.py # Streamable HTTP 传输层 + HTTP 端点 │ ├── services/ # 业务逻辑 │ │ ├── station_service.py # 车站数据服务（加载/搜索/编码转换） │ │ └── ticket_service.py # 票务查询核心（7 个工具实现） │ ├── utils/ # 配置与日期工具 │ │ ├── config.py # pydantic-settings 配置 │ │ └── date_utils.py # 日期校验工具 │ └── resources/ # 静态资源（车站数据 station_name.js） ├── scripts/ # 运维脚本 │ ├── start_server.py # HTTP 模式一键启动（环境自检） │ └── update_stations.py # 更新车站数据 ├── docs/ # 工具详细文档 ├── pyproject.toml # 项目元数据 / 依赖 / 构建配置 ├── Dockerfile # 多阶段构建（python:3.12-alpine） ├── server.json # MCP 注册表元数据 └── uv.lock # 依赖锁文件

🧑💻 开发指南

# 1. 克隆并初始化

git clone https://github.com/drfccv/mcp-server-12306.git cd mcp-server-12306 uv sync

2. 类型检查（mypy，严格模式）

uv run mypy src scripts

3. 代码格式化

uv run black src scripts uv run isort src scripts

4. 构建与发布

uv run python -m build uv run twine upload dist/*

架构要点：

server.py 是传输无关的核心模块——工具注册（TOOL_HANDLERS）与业务分发（call_tool）都在此，stdio 与 HTTP 复用同一实例，保证两种模式行为完全一致。
工具 Schema 单一来源于 ticket_service.MCP_TOOLS，HTTP 的 /schema/tools 端点与 MCP 工具列表同源。
网络请求统一走 _request_with_retry（自动重试 + init 会话保持），业务错误与网络错误分离处理。

📚 详细文档

文档	内容
query_tickets.md	余票 / 车次 / 座席 / 时刻一站式查询
query_ticket_price.md	实时票价查询
search_stations.md	车站智能搜索
query_transfer.md	中转换乘方案
get_train_route_stations.md	列车经停站查询
get_current_time.md	当前时间与相对日期

每份文档均包含：功能说明、实现方法、请求参数、返回示例与典型调用方式。

⚠️ 免责声明

本项目仅供学习、研究与技术交流，严禁用于任何商业用途。
本项目仅作为官方公开接口的智能聚合与转发。
使用本项目造成的任何后果（包括但不限于账号封禁、数据异常、法律风险等）均由使用者本人承担，项目作者不承担任何责任。
请遵守中国法律法规及 12306 官方相关规定，合理合规使用。

📄 License

MIT © Drfccv

⭐ 如果这个项目对你有帮助，欢迎 Star 支持！

MCP Server 12306

What it does

Instalación

Instala uv (si no lo tienes)

Abre el archivo de configuración de la app de Claude de escritorio

Pega esta configuración y guarda el archivo

Cierra Claude y vuelve a abrirlo

Pruébalo

Lo que puedes hacer en su lugar

Instala uv (si no lo tienes)

Abre la Terminal

Pega este comando y pulsa Enter

Escribe /mcp en Claude Code

Pruébalo

Instala uv (si no lo tienes)

Pulsa este botón para abrir Cursor

Abre el chat de IA de Cursor en modo Agent

Pruébalo

Instala uv (si no lo tienes)

Pulsa este botón para abrir VS Code

Abre el chat de IA de VS Code en modo Agent

Pruébalo

Instalado en tu computadora

De un vistazo

Qué apps pueden usarlo

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Vulnerabilidades publicadas (OSV.dev)

Conversación

Reseñas de usuarios

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas parecidas

World Monitor

openstatus

Oh My Posh Validator

Strata

Jitsu

README del creador

🚄 MCP Server 12306

📑 目录

✨ 功能特性

🚀 快速开始

环境要求

方式一：Stdio 模式（本地客户端推荐）

或 pip / pipx

方式二：Streamable HTTP 模式（远程部署）

或本地源码启动

方式三：Docker 部署

自定义端口

🛠️ 工具一览

⚙️ 配置项

🏗️ 项目结构

🧑💻 开发指南

2. 类型检查（mypy，严格模式）

3. 代码格式化

4. 构建与发布

📚 详细文档

⚠️ 免责声明

📄 License