12306-mcp

★ 1,100

from Joooook

Search for train tickets on 12306, the official China Railway website.

🔥🔥🔥✓ VerifiedFreeQuick setup

12306-mcp

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 🚧 计划内

📚Documentation

服务原理详解 12306-MCP服务的工作原理
架构图 12306-MCP服务的架构图

👉️Reference

💭Murmurs

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

🎫Badges

☕️Donate

请我喝杯奶茶吧。

Copy & paste — that's it

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

⚙️Installation

Copy & paste — that's it

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

▶️Quick Start

CLI-stdio

Copy & paste — that's it

npx -y 12306-mcp

CLI-http

Copy & paste — that's it

npx -y 12306-mcp --port [端口号]

MCP sever configuration

Copy & paste — that's it

{
 "mcpServers": {
 "12306-mcp": {
 "command": "npx",
 "args": [
 "-y",
 "12306-mcp"
 ]
 }
 }
}

Docker-stdio

Copy & paste — that's it

docker build . -t 12306-mcp
docker run --rm -it 12306-mcp npx 12306-mcp

Docker-http

Copy & paste — that's it

docker build . -t 12306-mcp
docker run -p [your_port]:8080 -d 12306-mcp npx 12306-mcp --port 8080