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

0 阅读4分钟

在数字化出行日益普及的今天,铁路出行已成为国民交通的重要选择。12306-MCP 作为连接开发者与铁路票务系统的桥梁,正在改变我们获取铁路出行信息的方式。本文将带您全面了解 12306-MCP 的定义、安装方法、使用场景以及其带来的变革意义。

一、12306-MCP 是什么?

12306-MCP 是基于中国铁路客户服务中心(12306)官方数据接口开发的开放式出行服务组件,它通过 MCP(Model Control Protocol,模型控制协议)封装,为开发者提供标准化的铁路票务与行程信息服务。

1、主要功能模块

12306-MCP 提供了一系列实用的功能接口:

  1. 车站信息查询

    1. get-stations-code-in-city:通过城市名查询该城市所有车站代码

    2. get-station-code-of-city:通过城市名查询该城市对应的唯一车站代码

    3. get-station-code-by-name:通过车站名查询唯一车站代码

    4. get-station-by-telecode:通过车站电报码查询车站信息

  2. 票务信息查询

    1. get-tickets:查询 12306 余票信息,支持多条件筛选
  3. 列车信息查询

    1. 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 配置

  1. 在 Trae 的 MCP 市场中,搜索 12306 没有搜到该 mcp,所以需要点击手动配置进入配置界面

  1. 粘贴如下代码块到配置框中
{
  "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 作为铁路票务数据的"开发者友好"接口,正在重塑我们获取和使用铁路出行信息的方式。它的价值主要体现在以下几个方面:

  1. 开发效率革命:通过标准化接口,开发者无需从零开始对接复杂的 12306 系统,节省了大量开发时间和成本。
  2. 创新应用孵化:为智能出行助手、旅游平台、企业差旅系统等应用提供了坚实的数据基础,激发了出行服务领域的创新。
  3. 用户体验提升:最终用户可以通过集成 12306-MCP 的应用获得更便捷、更智能的票务查询和行程规划体验。
  4. 生态协同效应:作为 MCP 生态的一部分,12306-MCP 可以与其他 MCP 服务无缝连接,创造 1+1>2 的价值。