12306车票查询

Joooook

640

Favorite:

A ticket search server for 12306 based on the Model Context Protocol (MCP).

Content

# <div align="center">12306-mcp</div> <div align="center"> [![](https://img.shields.io/badge/Joooook-blue.svg?logo=github&lable=python&labelColor=497568&color=497568&style=flat-square)](https://github.com/Joooook) [![](https://img.shields.io/badge/Joooook-blue.svg?logo=bilibili&logoColor=white&lable=python&labelColor=af7a82&color=af7a82&style=flat-square)](https://space.bilibili.com/3546386788255839) ![](https://img.shields.io/badge/typescript-blue.svg?logo=typescript&lable=typescript&logoColor=white&labelColor=192c3b&color=192c3b&style=flat-square) ![](https://img.shields.io/github/stars/Joooook/12306-mcp?logo=reverbnation&lable=python&logoColor=white&labelColor=ffc773&color=ffc773&style=flat-square) ![](https://img.shields.io/github/last-commit/Joooook/12306-mcp.svg?style=flat-square) ![](https://img.shields.io/github/license/Joooook/12306-mcp.svg?style=flat-square&color=000000) </div> 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购票信息。 ## <div align="center">🚩Features</div> <div align="center"> | 功能描述 | 状态 | |------------------------------|--------| | 查询12306购票信息 | ✅ 已完成 | | 过滤列车信息 | ✅ 已完成 | | 过站查询 | ✅ 已完成 | | 中转查询 | ✅ 已完成 | | 其余接口，欢迎提feature | 🚧 计划内 | </div> <div align="center"> <img src="https://s2.loli.net/2025/04/15/UjbrG5esaSEmJxN.jpg" width=800px/> </div> <div align="center"> <img src="https://s2.loli.net/2025/04/15/rm1j8zX7sqiyafP.jpg" width=800px/> </div> ## <div align="center">⚙️Installation</div> ~~~bash git clone https://github.com/Joooook/12306-mcp.git npm i ~~~ ## <div align="center">▶️Quick Start</div> ### CLI-stdio ~~~bash npx -y 12306-mcp ~~~ ### CLI-http ~~~bash npx -y 12306-mcp --port [端口号] ~~~ ### MCP sever configuration ~~~json { "mcpServers": { "12306-mcp": { "command": "npx", "args": [ "-y", "12306-mcp" ] } } } ~~~ ### Docker-stdio ~~~bash docker build . -t 12306-mcp docker run --rm -it 12306-mcp npx 12306-mcp ~~~ ### Docker-http ~~~bash docker build . -t 12306-mcp docker run -p [your_port]:8080 -d 12306-mcp npx 12306-mcp --port 8080 ~~~ ## <div align="center">📚Documentation</div> - [服务原理详解](./docs/principle.md) 12306-MCP服务的工作原理 - [架构图](./docs/architecture.md) 12306-MCP服务的架构图 ![12306-MCP 服务架构图](./docs/architecture.png) ## <div align="center">👉️Reference</div> - [modelcontextprotocol/modelcontextprotocol](https://github.com/modelcontextprotocol/modelcontextprotocol) - [modelcontextprotocol/typescript-sdk](https://github.com/modelcontextprotocol/typescript-sdk) ## <div align="center">💭Murmurs</div> 本项目仅用于学习，欢迎催更。 ## <div align="center">🎫Badges</div> <div align="center"> <a href="https://glama.ai/mcp/servers/@Joooook/12306-mcp"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@Joooook/12306-mcp/badge" alt="12306-mcp MCP server" /> </a> [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/joooook-12306-mcp-badge.png)](https://mseep.ai/app/joooook-12306-mcp) </div> ## <div align="center">☕️Donate</div> 请我喝杯奶茶吧。 <div align="center"> <a href="https://afdian.com/item/2a0e0cdcadf911ef9f725254001e7c00"> <img src="https://s2.loli.net/2024/11/29/1JBxzphs7V6WcK9.jpg" width="500px"> </a> </div>

Tool List

get-current-date

get-stations-code-in-city

Description: 通过中文城市名查询该城市 **所有** 火车站的名称及其对应的 `station_code`，结果是一个包含多个车站信息的列表。

Parameters

city Type: string Required: Yes

中文城市名称，例如："北京", "上海"

get-station-code-of-citys

Description: 通过中文城市名查询代表该城市的 `station_code`。此接口主要用于在用户提供**城市名**作为出发地或到达地时，为接口准备 `station_code` 参数。

Parameters

citys Type: string Required: Yes

要查询的城市，比如"北京"。若要查询多个城市，请用|分割，比如"北京|上海"。

get-station-code-by-names

Description: 通过具体的中文车站名查询其 `station_code` 和车站名。此接口主要用于在用户提供**具体车站名**作为出发地或到达地时，为接口准备 `station_code` 参数。

Parameters

stationNames Type: string Required: Yes

具体的中文车站名称，例如："北京南", "上海虹桥"。若要查询多个站点，请用|分割，比如"北京南|上海虹桥"。

get-station-by-telecode

Description: 通过车站的 `station_telecode` 查询车站的详细信息，包括名称、拼音、所属城市等。此接口主要用于在已知 `telecode` 的情况下获取更完整的车站数据，或用于特殊查询及调试目的。一般用户对话流程中较少直接触发。

Parameters

stationTelecode Type: string Required: Yes

车站的 `station_telecode` (3位字母编码)

get-tickets

Description: 查询12306余票信息。

Parameters

date Type: string Required: Yes

查询日期，格式为 "yyyy-MM-dd"。如果用户提供的是相对日期（如“明天”），请务必先调用 `get-current-date` 接口获取当前日期，并计算出目标日期。

fromStation Type: string Required: Yes

出发地的 `station_code` 。必须是通过 `get-station-code-by-names` 或 `get-station-code-of-citys` 接口查询得到的编码，严禁直接使用中文地名。

toStation Type: string Required: Yes

到达地的 `station_code` 。必须是通过 `get-station-code-by-names` 或 `get-station-code-of-citys` 接口查询得到的编码，严禁直接使用中文地名。

trainFilterFlags Type: string Required: No

车次筛选条件，默认为空，即不筛选。支持多个标志同时筛选。例如用户说“高铁票”，则应使用 "G"。可选标志：[G(高铁/城际),D(动车),Z(直达特快),T(特快),K(快速),O(其他),F(复兴号),S(智能动车组)]

sortFlag Type: string Required: No

排序方式，默认为空，即不排序。仅支持单一标识。可选标志：[startTime(出发时间从早到晚), arriveTime(抵达时间从早到晚), duration(历时从短到长)]

sortReverse Type: boolean Required: No

是否逆向排序结果，默认为false。仅在设置了sortFlag时生效。

limitedNum Type: number Required: No

返回的余票数量限制，默认为0，即不限制。

get-interline-tickets

Description: 查询12306中转余票信息。尚且只支持查询前十条。

Parameters

date Type: string Required: Yes

查询日期，格式为 "yyyy-MM-dd"。如果用户提供的是相对日期（如“明天”），请务必先调用 `get-current-date` 接口获取当前日期，并计算出目标日期。

fromStation Type: string Required: Yes

出发地的 `station_code` 。必须是通过 `get-station-code-by-names` 或 `get-station-code-of-citys` 接口查询得到的编码，严禁直接使用中文地名。

toStation Type: string Required: Yes

出发地的 `station_code` 。必须是通过 `get-station-code-by-names` 或 `get-station-code-of-citys` 接口查询得到的编码，严禁直接使用中文地名。

middleStation Type: string Required: No

中转地的 `station_code` ，可选。必须是通过 `get-station-code-by-names` 或 `get-station-code-of-citys` 接口查询得到的编码，严禁直接使用中文地名。

showWZ Type: boolean Required: No

是否显示无座车，默认不显示无座车。

trainFilterFlags Type: string Required: No

车次筛选条件，默认为空。从以下标志中选取多个条件组合[G(高铁/城际),D(动车),Z(直达特快),T(特快),K(快速),O(其他),F(复兴号),S(智能动车组)]

sortFlag Type: string Required: No

排序方式，默认为空，即不排序。仅支持单一标识。可选标志：[startTime(出发时间从早到晚), arriveTime(抵达时间从早到晚), duration(历时从短到长)]

sortReverse Type: boolean Required: No

是否逆向排序结果，默认为false。仅在设置了sortFlag时生效。

limitedNum Type: number Required: No

返回的中转余票数量限制，默认为10。

get-train-route-stations

Description: 查询特定列车车次在指定区间内的途径车站、到站时间、出发时间及停留时间等详细经停信息。当用户询问某趟具体列车的经停站时使用此接口。

Parameters

trainNo Type: string Required: Yes

要查询的实际车次编号 `train_no`，例如 "240000G10336"，而非"G1033"。此编号通常可以从 `get-tickets` 的查询结果中获取，或者由用户直接提供。

fromStationTelecode Type: string Required: Yes

该列车行程的**出发站**的 `station_telecode` (3位字母编码`)。通常来自 `get-tickets` 结果中的 `telecode` 字段，或者通过 `get-station-code-by-names` 得到。

toStationTelecode Type: string Required: Yes

该列车行程的**到达站**的 `station_telecode` (3位字母编码)。通常来自 `get-tickets` 结果中的 `telecode` 字段，或者通过 `get-station-code-by-names` 得到。

departDate Type: string Required: Yes

列车从 `fromStationTelecode` 指定的车站出发的日期 (格式: yyyy-MM-dd)。如果用户提供的是相对日期，请务必先调用 `get-current-date` 解析。

12306车票查询

Content

Tool List

get-current-date

get-stations-code-in-city

Parameters

get-station-code-of-citys

Parameters

get-station-code-by-names

Parameters

get-station-by-telecode

Parameters

get-tickets

Parameters

get-interline-tickets

Parameters

get-train-route-stations

Parameters

Connection Info

You Might Also Like

mcp-chrome

firecrawl

Firecrawl

CodeIndexer

code-context

claude-context

12306车票查询

Scan with WeChat to Share

Authentication Required

Content

Tool List

get-current-date

get-stations-code-in-city

Parameters

get-station-code-of-citys

Parameters

get-station-code-by-names

Parameters

get-station-by-telecode

Parameters

get-tickets

Parameters

get-interline-tickets

Parameters

get-train-route-stations

Parameters

Connection Info

You Might Also Like

mcp-chrome

firecrawl

Firecrawl

CodeIndexer

code-context

claude-context