12306-mcp README

The project's README from github.com/Joooook/12306-mcp. As one markdown file: README.md.

12306-mcp

A 12306 ticket search server based on the Model Context Protocol (MCP). The server provides a simple API interface that allows users to search for 12306 tickets.

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

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

🚩Features

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

⚙️Installation

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

▶️Quick Start

CLI-stdio

npx -y 12306-mcp

CLI-http

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

Runtime requirements

The server requires Node.js 18 or newer. The npm run debug command uses MCP Inspector 2.0.0, which requires Node.js 22.19.0 or newer.

MCP sever configuration

{
    "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

📚Documentation

👉️Reference

💭Murmurs

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

🎫Badges

12306-mcp MCP server

MseeP.ai Security Assessment Badge

☕️Donate

请我喝杯奶茶吧。

12306-mcp (Joooook/12306-mcp)

Searching Database…

这是什么?12306-mcp 是一个 Model Context Protocol(MCP)服务器,让 AI 模型可以通过简单的 API 在中国 12306 铁路购票系统上查询火车票。
这是一个独立应用,还是接入我的 AI 助手的服务器?它是一个 MCP 服务器:你先运行它,再把它连接到兼容 MCP 的 AI 客户端(比如 Claude 或其他 LLM 工具),由客户端调用它的 API 来查询车票。
怎么把它跑起来?你可以直接通过 CLI 以 stdio 或 HTTP 模式运行,或使用现成的 Docker 配置(Docker-stdio 或 Docker-http),然后把 MCP 客户端配置指向它。
运行它需要安装什么?需要 Node.js 18 或更高版本;使用 MCP Inspector 2.0.0 运行调试命令则需要 Node.js 22.19.0 或更高版本。
它能用于真实购票吗,还是只适合学习?作者声明该项目仅供学习用途,并非经官方认可的、有保障的生产级购票工具。
谁会用这个?需要查询中国火车时刻表和余票、又不想手动浏览 12306 网站的 AI 智能体或聊天机器人开发者。
它支持哪些车票查询?它支持标准的 12306 车票搜索、按条件筛选车次、查询线路沿途停靠站,以及中转/换乘路线查询。
使用它需要 12306 账号或 API 密钥吗?README 没有提到需要 12306 账号或 API 密钥——只需要运行服务器并连接一个 MCP 客户端即可。
还有更多功能在计划中吗?有,README 把更多接口列为计划内(“计划内”),并邀请用户提出功能需求。
Creator
Joooook
Size
0.6 MB
Stars
2.4K
Age
1y
Commits · 90 Days