12306MCP工具（作者：@Joooook）
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"12306-mcp": {
"args": [
"-y",
"12306-mcp"
],
"command": "npx"
}
}
}可用工具 （8 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
get-current-date
获取当前日期，以上海时区（Asia/Shanghai, UTC+8）为准，返回格式为 "yyyy-MM-dd"。主要用于解析用户提到的相对日期（如“明天”、“下周三”），为其他需要日期的接口提供准确的日期输入。
该工具无需必填参数，直接调用即可
get-stations-code-in-city 1 个参数 需填 1 项
通过中文城市名查询该城市 **所有** 火车站的名称及其对应的 `station_code`，结果是一个包含多个车站信息的列表。
必填参数：city
get-station-code-of-citys 1 个参数 需填 1 项
通过中文城市名查询代表该城市的 `station_code`。此接口主要用于在用户提供**城市名**作为出发地或到达地时，为接口准备 `station_code` 参数。
必填参数：citys
get-station-code-by-names 1 个参数 需填 1 项
通过具体的中文车站名查询其 `station_code` 和车站名。此接口主要用于在用户提供**具体车站名**作为出发地或到达地时，为接口准备 `station_code` 参数。
必填参数：stationNames
get-station-by-telecode 1 个参数 需填 1 项
通过车站的 `station_telecode` 查询车站的详细信息，包括名称、拼音、所属城市等。此接口主要用于在已知 `telecode` 的情况下获取更完整的车站数据，或用于特殊查询及调试目的。一般用户对话流程中较少直接触发。
必填参数：stationTelecode
get-tickets 10 个参数 需填 3 项
查询12306余票信息。
必填参数：date、fromStation、toStation
get-interline-tickets 11 个参数 需填 3 项
查询12306中转余票信息。尚且只支持查询前十条。
必填参数：date、fromStation、toStation
get-train-route-stations 4 个参数 需填 4 项
查询特定列车车次在指定区间内的途径车站、到站时间、出发时间及停留时间等详细经停信息。当用户询问某趟具体列车的经停站时使用此接口。
必填参数：trainNo、fromStationTelecode、toStationTelecode、departDate
服务介绍
12306-mcp
基于 Model Context Protocol (MCP) 的12306购票搜索服务器。提供了简单的API接口，允许大模型利用接口搜索12306购票信息。
🚩功能
| 功能描述 | 状态 |
|---|---|
| 查询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 [端口号]
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
📚文档
👉️参考
💭碎碎念
本项目作者：@Joooook，原项目链接：https://www.modelscope.cn/mcp/servers/@Joooook/12306-mcp。
🎫徽章
☕️捐赠
请我喝杯奶茶吧。
