A developer created a 12306 ticket query MCP server: 12306-mcp. It provides a simple API that allows AI assistants to directly query 12306 ticket information.
GitHub: https://github.com/Joooook/12306-mcp

Currently supports ticket query, train information filtering, station passing query, and transfer query.
What’s more exciting: with MCP, the entire travel process — from route planning, ticket purchase, to hotel booking — could be handled by AI in one go.

Joooook/12306-mcp

Source: https://github.com/Joooook/12306-mcp

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

⚙️Installation

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

▶️Quick Start

CLI-stdio

npx -y 12306-mcp  

CLI-http

npx -y 12306-mcp --port [port]  

MCP server configuration

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

Docker-stdio

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

Docker-http

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

📚Documentation

• Service Principle Details — How the 12306-MCP service works
• Architecture Diagram — Architecture diagram of the 12306-MCP service

12306-MCP Service Architecture Diagram

👉Reference

• modelcontextprotocol/modelcontextprotocol
• modelcontextprotocol/typescript-sdk

💭Murmurs

This project is for learning purposes only. Feel free to request updates.

🎫Badges

MseeP.ai Security Assessment Badge
https://mseep.ai/app/joooook-12306-mcp

☕Donate

Buy me a milk tea.