点击👇关注我 学习更多AI知识
大家好，我是予贝
在数字化出行日益普及的今天，铁路出行已成为国民交通的重要选择。12306-MCP 作为连接开发者与铁路票务系统的桥梁，正在改变我们获取铁路出行信息的方式。本文将带您全面了解 12306-MCP 的定义、安装方法、使用场景以及其带来的变革意义。
一、12306-MCP 是什么？
12306-MCP 是基于中国铁路客户服务中心（12306）官方数据接口开发的开放式出行服务组件，它通过 MCP（Model Control Protocol，模型控制协议）封装，为开发者提供标准化的铁路票务与行程信息服务。
1、主要功能模块
12306-MCP 提供了一系列实用的功能接口：
车站信息查询
-
get-stations-code-in-city：通过城市名查询该城市所有车站代码
-
get-station-code-of-city：通过城市名查询该城市对应的唯一车站代码
-
get-station-code-by-name：通过车站名查询唯一车站代码
-
get-station-by-telecode：通过车站电报码查询车站信息
票务信息查询
-
get-tickets：查询 12306 余票信息，支持多条件筛选
列车信息查询
-
get-train-route-stations：查询列车途经车站信息
这些功能模块的组合使用，可以构建出各种实用的铁路出行应用场景，从简单的余票查询到复杂的行程规划系统。
二、Trae 安装 12306-MCP
安装 12306-MCP 非常简单，以下是详细步骤：
1、下载源代码
该 mcp 服务需要提前下载和本地运行，所以需要先安装好 git 和 node 服务。
git clone https://github.com/Joooook/12306-mcp.git
cd 12306-mcp
npm i
2、程序构建运行
请确保有 node 环境
npm run build
node ./build/index.js
如下就是程序启动成功了
3、Trae 添加 12306-MCP 配置
在 Trae 的 MCP 市场中，搜索 12306 没有搜到该 mcp，所以需要点击手动配置进入配置界面
粘贴如下代码块到配置框中
{
"mcpServers": {
"12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}
返回 MCP 页面，确认"amap-amap-sse"显示为"可使用"状态
三、使用 12306-MCP
12306-MCP 的使用非常直观，下面通过几个典型场景展示其使用方法。
1. 基础查询示例
查询余票信息：
我想购买2025-05-20这天从北京到泸州的票，请帮我调用12306mcp查询一下余票信息
系统将返回该日期所有北京到泸州的车次及余票详情。
查询途径站点信息：
输入：请帮我查询车次G333途径站信息
返回 G333 次列车所有停靠站点及到发时间。
2. 高级应用：结合地图可视化
12306-MCP 可以与其他 MCP 服务结合使用，创造更丰富的应用体验。例如结合高德地图 MCP，将列车途径站点在地图上标注出来：
请将G333途径站点信息嵌入到网页中，帮我生成一段高德地图JSAPI代码，实现地图上标记出来途径的站点信息，并且以箭头图标的形式标记，各站点需要连成线，并且鼠标放到图标上可以显示到达时间，输出为yb.html
执行后会生成一个 yb.html 文件，打开即可看到 G333 次列车所有停靠站点在地图上的标注。
四、总结
12306-MCP 作为铁路票务数据的"开发者友好"接口，正在重塑我们获取和使用铁路出行信息的方式。它的价值主要体现在以下几个方面：
开发效率革命 ：通过标准化接口，开发者无需从零开始对接复杂的 12306 系统，节省了大量开发时间和成本。
创新应用孵化 ：为智能出行助手、旅游平台、企业差旅系统等应用提供了坚实的数据基础，激发了出行服务领域的创新。
用户体验提升 ：最终用户可以通过集成 12306-MCP 的应用获得更便捷、更智能的票务查询和行程规划体验。
生态协同效应 ：作为 MCP 生态的一部分，12306-MCP 可以与其他 MCP 服务无缝连接，创造 1+1>2 的价值。
我们坚信AI编程的门槛会变得越来越低，开源了AI编程手册，目前85000多字，包含网站，小程序，APP等多种开发案例，希望对大家有帮助，需要的扫码获取