12306-mcp

[![](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)

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服务的架构图 ![12306-MCP 服务架构图](./docs/architecture.png) ##

👉️Reference

- [modelcontextprotocol/modelcontextprotocol](https://github.com/modelcontextprotocol/modelcontextprotocol) - [modelcontextprotocol/typescript-sdk](https://github.com/modelcontextprotocol/typescript-sdk) ##

💭Murmurs

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

🎫Badges

[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/joooook-12306-mcp-badge.png)](https://mseep.ai/app/joooook-12306-mcp)

☕️Donate

请我喝杯奶茶吧。

12306 Mcp

Install

12306 Mcp

Install