返回 MCP 目录
public公开dns本地运行

12306-mcp

基于MCP协议的12306购票搜索服务器,提供API接口支持AI智能查询车票信息

article

README

🚀 一个基于MCP的12306购票搜索服务器

这是一个基于 Model Context Protocol (MCP) 的12306购票搜索服务器,提供简单的 API 接口,允许大模型利用该接口搜索 12306 购票信息。

🚀 快速开始

命令行界面(CLI)

npm run build
node ./build/index.js

MCP 服务器配置

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

✨ 主要特性

| 功能描述 | 状态 | | ---- | ---- | | 查询 12306 购票信息 | ✅ 已完成 | | 过滤列车信息 | ✅ 已完成 | | 过站查询 | ✅ 已完成 | | 中转查询 | ✅ 已完成 | | 其余接口,欢迎提 feature | 🚧 计划内 |

📦 安装指南

git clone https://github.com/freestylefly/12306-mcp.git
npm i

💻 使用示例

基础用法

本项目在不同场景下有多种使用方式,以下为你详细介绍:

在 Cursor 中使用

可以智能选票还能生成途径站点可视化地图! 教程:Cursor + 12306 MCP,实现AI智能选票还能生成精美网站

在 Cursor 中使用

在 yb.html 中可直接用浏览器打开

yb.html 效果

用阿里云百炼做智能体

教程:阿里百炼+12306 MCP,打造AI智能选票智能体,超酷的!

阿里云百炼智能体示例1

例如输入:“我在后天想从西安出发去往郑州,请推荐出合理的车票,并推荐三天后返程的车票”

阿里云百炼智能体示例2

还能对比各个列车票价,做个图表,更直观了。

票价对比图表

同样能让它生成列车停靠站点地图:

列车停靠站点地图

还能生成途径站点的旅行攻略。这里的逻辑是先让它去网上搜,搜不到就调用文生图模型,由 AI 生成图片。

途径站点旅行攻略

阿里自带的这个生图 MCP 感觉能力还是挺强的。

生图效果1

感觉跟真的也差不多啊,哈哈哈。

生图效果2

说实话,在火车上看着自己坐的这一趟列车途径的城市,看着这些景点,心中难免有一丝丝的冲动。

旅行感受

📚 详细文档

参考资料

项目来源

本项目源自12306-MCP ,感谢作者,本项目仅用于学习,欢迎催更。

友情链接

  • mcp-server-weread :🚀基于 Model Context Protocol (MCP) 的12306购票搜索服务器。提供了简单的 API 接口,允许大模型利用接口搜索 12306 购票信息。
  • 12306-MCP :🚀一个为微信读书提供 MCP(Model Context Protocol)服务的工具,支持将微信读书的书籍、笔记和划线数据提供给支持 MCP 的大语言模型客户端,如 Claude Desktop。
  • CodeCanvas :📚本代码仓库是作者苍何多年从事一线互联网 Java 开发的学习历程技术汇总,旨在为大家提供一个清晰详细的学习教程,侧重点更倾向编写 Java 核心内容。💪🏻
  • PmHub :🔥PmHub 是一套基于 SpringCloud & LLM 的微服务智能项目管理系统,这个项目旨在帮助小伙伴们快速掌握微服务/分布式项目的架构设计和开发流程,如果想在校招或者社招中拿到一个满意的 offer,PmHub 将是一个非常 nice 的选择。

star 趋势图

Star History Chart

公众号

微信搜 苍何 或扫描下方二维码关注苍何的原创公众号,回复 AI 即可和 5000+ 好友一同探讨 AI,一同学习 MCP。

苍何微信公众号

📄 许可证

MIT License (MIT)

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

Copyright (c) 2025 - 2026 12306 - MCP

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端