12306 Mcp

12306-mcp

[](https://github.com/Joooook) [](https://space.bilibili.com/3546386788255839)

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购票信息。

🚩Features

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

⚙️Installation

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

▶️Quick Start

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 ~~~

📚Documentation

• [服务原理详解](./docs/principle.md) 12306-MCP服务的工作原理
• [架构图](./docs/architecture.md) 12306-MCP服务的架构图

👉️Reference

• modelcontextprotocol/modelcontextprotocol
• modelcontextprotocol/typescript-sdk

💭Murmurs

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

🎫Badges

[](https://mseep.ai/app/joooook-12306-mcp)

☕️Donate

请我喝杯奶茶吧。

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Joooook
• Source: Joooook/12306-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.