12306 Mcp
About
This is a 12306 ticket search server based on the Model Context Protocol (MCP).
Details
- Author
- Joooook
- GitHub stars
- 1,079
- Downloads
- 686
- Categories
- Search, Knowledge Base, Other
Jump to
- Query 12306 ticket information
- Filter train information
- Pass-through station query
- Transfer (connecting) query
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
12306 McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository and run npm i. Use npx -y 12306-mcp to start with stdio transport, or npx -y 12306-mcp --port [port] for HTTP transport. Docker images can be built and run with similar commands. The MCP server configuration for clients requires setting the command and args as shown in the README.
get-current-date
获取当前日期，以上海时区（Asia/Shanghai, UTC+8）为准，返回格式为 "yyyy-MM-dd"。主要用于解析用户提到的相对日期（如“明天”、“下周三”），提供准确的日期输入。
get-stations-code-in-city
通过中文城市名查询该城市 **所有** 火车站的名称及其对应的 `station_code`，结果是一个包含多个车站信息的列表。
get-station-code-of-citys
通过中文城市名查询代表该城市的 `station_code`。
get-station-code-by-names
通过具体的中文车站名查询其 `station_code` 和车站名。
get-station-by-telecode
通过车站的 `station_telecode` 查询车站的详细信息，包括名称、拼音、所属城市等。此接口主要用于在已知 `telecode` 的情况下获取更完整的车站数据，或用于特殊查询及调试目的。一般用户对话流程中较少直接触发。
get-tickets
查询12306余票信息。
get-interline-tickets
查询12306中转余票信息。尚且只支持查询前十条。
get-train-route-stations
查询特定列车车次在指定区间内的途径车站、到站时间、出发时间及停留时间等详细经停信息。当用户询问某趟具体列车的经停站时使用此接口。
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"12306 mcp": {
"12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}
}McpServers
{
"12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
