12306-mcp使用指南

简介

12306-mcp 是基于中国铁路客户服务中心（12306）数据接口开发的开放式出行服务组件，旨在为开发者、企业和智能应用提供高效、标准化的铁路票务与行程信息服务。该组件通过 MCP（Model Control Protocol，模型控制协议）协议封装，支持多种场景下的铁路数据查询、余票检索、车站与车次信息获取、行程规划等功能，极大地提升了铁路出行相关应用的开发效率和用户体验。

12306-mcp 的核心优势在于其接口的标准化和易用性。开发者可以通过简单的 API 调用，快速获取全国铁路车站代码、车次时刻表、余票信息、途径站点、票价等关键数据。例如，用户只需输入出发地、目的地和日期，即可获得所有可选车次及余票详情，并可进一步查询每一趟列车的途径站点和停靠时间。这为智能出行助手、旅游平台、企业差旅管理等场景提供了坚实的数据基础。

快速开始

在 Cursor 的 Cursor Settings 中找到 MCP，点击右侧上方的 Add new global MCP server 按钮，便自动打开 mcp.json文件，然后将mcp server 的配置信息粘贴进去。

{
  "mcpServers": {
    12306-mcp": {
      "command": "npx",
      "args": [
          "-y",
          "12306-mcp"
      ]
  	}
  }
}

在MCP页面就可以看到配置的 mcp server 信息。

12306-mcp的工具列表如下：

get-stations-code-in-city：通过城市名查询该城市所有车站的station_code，结果为列表。

get-station-code-of-city：通过城市名查询该城市对应的station_code，结果是唯一的。

get-station-code-by-name：通过车站名查询station_code，结果是唯一的。

get-station-by-telecode：通过station_telecode查询车站信息，结果是唯一的。

get-tickets：查询12306余票信息。

get-train-route-stations：查询列车途径车站信息。

实操

查询余票信息

输入：我想购买2025-05-20这天从苏州北到青岛的票，请帮我查询一下余票信息

查询铁路站点信息

输入：我想知道苏州所有的站点信息

查询途径站点信息

输入：请帮我查询车次G222途径站信息

还可以结合高德地图mcp（确保已经配置）将该车次途径站点信息通过地图标注出来

输入：请将G222途径站点信息嵌入到网页中，帮我生成一段高德地图JSAPI 代码，实现地图上标记出来途径的站点信息，输出为sz.html

打开sz.html如下图：