<div align="center">12306-mcp</div>

<div align="center">

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

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

<div align="center">▶️Quick Start</div>

CLI

npx -y 12306-mcp

MCP sever configuration

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

<div align="center">📚Documentation</div>

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

<div align="center">👉️Reference</div>

• modelcontextprotocol/modelcontextprotocol
• 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>

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