Trae + 12306MCP，10分钟搭建行程可视化助手

在数字化出行日益普及的今天，铁路出行已成为国民交通的重要选择。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

列车信息查询

get-train-route-stations

这些功能模块的组合使用，可以构建出各种实用的铁路出行应用场景，从简单的余票查询到复杂的行程规划系统。

二、Trae 安装 12306-MCP

安装 12306-MCP 非常简单，以下是详细步骤：

1、下载源代码

该 mcp 服务需要提前下载和本地运行，所以需要先安装好 git 和 node 服务。

git clone https://github.com/Joooook/12306-mcp.gitcd 12306-mcpnpm i

2、程序构建运行

请确保有 node 环境

npm run buildnode ./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 作为铁路票务数据的"开发者友好"接口，正在重塑我们获取和使用铁路出行信息的方式。它的价值主要体现在以下几个方面：

开发效率革命

创新应用孵化

用户体验提升

生态协同效应