12306 Mcp

Name: 12306 Mcp
Author: Joooook

本地服务

github.com/Joooook地图与出行2.4k13 周前更新

代码仓库

关于 12306 Mcp

12306-mcp 是基于 Model Context Protocol 的 12306 购票搜索服务，允许大模型查询列车票务信息。它支持余票查询、车次过滤、过站查询和中转查询，适合需要检索火车票信息的 AI 助手或开发者。

主要功能

01查询 12306 购票信息
02按条件过滤列车信息
03过站查询
04中转查询
05支持 stdio 与 HTTP 两种运行方式

适用场景

01让 AI 助手查询指定日期与线路的余票
02筛选符合条件的车次
03查询经停站与中转方案

MCP 相关

该项目是 MCP 服务，向大模型和 MCP 客户端提供 12306 购票信息的搜索接口。

#mcp #12306 #train-tickets #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y 12306-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm12306-mcpstdio

工具

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

12306-mcp

README 配图

基于 Model Context Protocol（MCP）的 12306 车票查询服务。该服务提供了简单的 API 接口，允许用户查询 12306 车票。

基于 Model Context Protocol（MCP）的 12306 购票搜索服务。提供了简单的 API 接口，允许大模型利用接口搜索 12306 购票信息。

如需 Skill -> https://github.com/Joooook/12306-skill

🚩功能

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

⚙️安装

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

▶️快速开始

CLI-stdio

npx -y 12306-mcp

CLI-http

npx -y 12306-mcp --port [端口号]

运行时要求

服务需要 Node.js 18 或更高版本。npm run debug 命令使用 MCP Inspector 2.0.0，该工具需要 Node.js 22.19.0 或更高版本。

MCP 服务配置

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

Docker-stdio

docker build . -t 12306-mcp
docker run --rm -it 12306-mcp npx 12306-mcp

Docker-http

docker build . -t 12306-mcp
docker run -p [your_port]:8080 -d 12306-mcp npx 12306-mcp --port 8080

📚文档

服务原理详解 12306-MCP 服务的工作原理
架构图 12306-MCP 服务的架构图

👉️参考

💭絮语

本项目仅用于学习，欢迎催更。

🎫徽章

☕️捐赠

请我喝杯奶茶吧。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。