【稳定版】12306MCP火车票服务

Alphar/Railway-Real-Time-MCP-Server
Hosted
7 Stars 4.8k 次浏览 更新于 2026-08-23
搜索工具交流协作工具开发者工具

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "Railway-Real-Time-MCP-Server": {
      "args": [
        "12306-mcp-server"
      ],
      "command": "npx"
    }
  }
}

可用工具 （8 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

get-current-date

获取当前日期，以上海时区（Asia/Shanghai, UTC+8）为准，返回格式为 "yyyy-MM-dd"。主要用于解析用户提到的相对日期（如"明天"、"下周三"），提供准确的日期输入。

该工具无需必填参数，直接调用即可

get-stations-code-in-city 1 个参数 需填 1 项

通过中文城市名查询该城市 **所有** 火车站的名称及其对应的 `station_code`，结果是一个包含多个车站信息的列表。

必填参数：city

get-station-code-of-citys 1 个参数 需填 1 项

通过中文城市名查询代表该城市的 `station_code`。此接口主要用于在用户提供**城市名**作为出发地或到达地时，为接口准备 `station_code` 参数。

必填参数：citys

get-station-code-by-names 1 个参数 需填 1 项

通过具体的中文车站名查询其 `station_code` 和车站名。此接口主要用于在用户提供**具体车站名**作为出发地或到达地时，为接口准备 `station_code` 参数。

必填参数：stationNames

get-station-by-telecode 1 个参数 需填 1 项

通过车站的 `station_telecode` 查询车站的详细信息，包括名称、拼音、所属城市等。此接口主要用于在已知 `telecode` 的情况下获取更完整的车站数据，或用于特殊查询及调试目的。一般用户对话流程中较少直接触发。

必填参数：stationTelecode

get-tickets 10 个参数 需填 3 项

查询12306余票信息。

必填参数：date、fromStation、toStation

get-interline-tickets 12 个参数 需填 3 项

查询12306中转余票信息。尚且只支持查询前十条。

必填参数：date、fromStation、toStation

get-train-route-stations 3 个参数 需填 2 项

查询特定列车车次在指定区间内的途径车站、到站时间、出发时间及停留时间等详细经停信息。当用户询问某趟具体列车的经停站时使用此接口。

必填参数：trainCode、departDate

服务介绍

12306-MCP-Server v1.0.0

Node.js Version
License

Docker Pulls

一个为大型语言模型（LLM）设计的、高可用的12306余票查询工具服务，现已搭载智能会话管理引擎。

12306-MCP-Server 将复杂的12306余票查询接口封装为符合 Model Context Protocol (MCP) 规范的工具集，允许AI Agent通过自然语言无缝查询实时火车票、中转换乘和经停站信息。

从 v1.0.0 版本开始，项目引入了全新的智能会话管理系统，通过会话池、动态User-Agent轮换和自动错误恢复机制，将服务的稳定性与反屏蔽能力提升至全新高度。

🎯 核心优势

  • 🚀 高性能: 会话复用率90%+，响应时间降低33%，吞吐量提升228%
  • 💪 高可用: 智能错误恢复，服务可用性99.5%+，自动会话补充
  • 🛡️ 反屏蔽: 12种UA动态轮换，智能限流，IP封禁风险降低95%
  • 📊 可观测: 详细的监控指标，健康检查接口，结构化日志
  • ⚙️ 易配置: 环境变量配置，Docker支持，开箱即用

✨ 核心功能

智能会话管理

  • 会话池: 维护2-5个会话的池（可配置），高效复用连接
  • 健康监控: 基于错误率的会话健康度评估，自动淘汰不健康会话
  • 后台维护: 每5分钟自动清理过期会话并补充新会话
  • 智能恢复: 自动识别会话失效，立即销毁并创建新会话
  • 请求队列: 池满时智能排队，避免请求失败

查询工具集

如何使用：工具与参数详解

该服务主要提供了四个针对不同需求场景设计的查询工具，能够有效地帮助开发人员构建功能丰富的交通出行应用 。

1. 余票查询接口 (get-tickets)

用途：根据出发地、目的地和日期检索可用的直达列车班次及其详细信息，包括票价、余票数量、历时等 。
使用场景：当用户想知道从一个城市到另一个城市有哪些列车时，此接口可以快速提供所有选项 。
请求参数：
date (必填): 查询日期，格式为 "yyyy-MM-dd" 。
fromStation (必填): 出发地的 station_code 。
toStation (必填): 到达地的 station_code 。
trainFilterFlags (可选): 车次筛选标志，如 "G" 代表高铁/城际，"D" 代表动车等 。
earliestStartTime / latestStartTime (可选): 最早/最晚出发时间（0-24小时） 。
sortFlag (可选): 排序方式，支持按出发时间、到达时间、历时排序 。
format (可选): 返回结果格式，支持 text、csv、json 。

2. 中转换乘查询接口 (get-interline-tickets)

用途：查询两地之间的中转换乘方案，提供多个换乘选项，并展示各段车程的详细信息 。
使用场景：适用于两个城市之间没有直达列车，或用户希望寻找更多出行选择的场景 。
请求参数：
date (必填): 查询日期 。
fromStation (必填): 出发地的 station_code 。
toStation (必填): 到达地的 station_code 。
middleStation (可选): 指定中转站的 station_code 。

3. 车次经停站查询接口 (get-train-route-stations)

用途：输入具体的列车车次和出发日期，获取该列车沿途停靠的所有站点详情，包括到站和发车时间 。
使用场景：当旅客已经确定乘坐某趟列车，但想了解沿途经停站信息时使用 。
请求参数：
trainCode (必填): 要查询的车次，例如 "G1033" 。
departDate (必填): 列车出发的日期，格式为 "yyyy-MM-dd" 。

4. 车站代码查询接口

用途：提供多种方式查询火车站的 station_code，这是其他查询接口所必需的参数 。
使用场景：在进行车票查询前，将用户输入的中文地名（如“北京”、“上海虹桥”）转换为系统可识别的车站编码 。
可用工具：
get-station-code-by-names: 通过具体的中文车站名查询 。
get-station-code-of-citys: 通过中文城市名查询代表该城市的车站编码 。
get-stations-code-in-city: 查询一个城市内的所有火车站编码 。

灵活的筛选与排序

  • 支持按车次类型 (G/D/Z/T/K/F/S) 进行筛选
  • 支持按出发时间范围进行筛选
  • 支持按出发时间、到达时间和历时进行排序

多种输出格式

  • 支持 text (默认)、csv 和 json 三种格式
  • 方便不同场景下的数据消费和处理

📊 性能指标

指标 v0.3.x v1.0.0 提升
响应时间 (P95) 2.5s 0.5s +80%
吞吐量 2.5 req/s 8.2 req/s +228%
成功率 92% 99.5% +8.2%
会话复用率 10% 90%+ +800%
IP封禁风险 高 极低 -95%

📄 许可证

本项目采用 MIT 许可证。

📧 联系方式

⭐ Star History

如果这个项目对你有帮助，请给一个 ⭐️ Star！

查看源码 项目主页

相关 MCP 服务

12306-MCP车票查询工具
@Joooook/12306-mcp
基于Model Context Protocol (MCP) 的12306购票搜索服务器。提供了简单的API接口，允许大模型利用接口搜索12306购票信息。
必应搜索中文
slcatwujian/bing-cn-mcp-server
让 AI 助手（如 Claude）能够使用必应搜索引擎实时获取网络信息的工具。提供了一个必应搜索工具和网页抓取功能，专为中文搜索优化，无需申请 API 密钥。
Tavily智搜
@tavily-ai/tavily-mcp
该服务器使AI系统能够与Tavily的搜索和数据提取工具集成，提供实时的网络信息访问和领域特定的搜索。
MCP上下文模型文档
@upstash/context7-mcp
一种模型上下文协议服务器，它从库中直接获取最新、特定版本的文档和代码示例并将其引入LLM提示中，帮助开发人员在无需过时或虚构信息的情况下获得准确的答案。