Joooook/12306-mcp

This is a 12306 ticket search server based on the Model Context Protocol (MCP).

What it solves

This project provides a way for Large Language Models (LLMs) to search for train ticket information from the 12306 (China Railway) system. It bridges the gap between an AI model and the official ticketing data by providing a standardized interface.

How it works

It is built as a server based on the Model Context Protocol (MCP), which allows AI models to interact with external tools and data. The server exposes a simple API that the LLM can use to query ticket availability and train details.

Who it’s for

Developers and AI users who want to integrate real-time Chinese railway ticket searching capabilities into their AI agents or LLM-powered applications.

Highlights

  • Comprehensive Search: Supports querying general ticket information, filtering specific trains, and performing stop-over or transfer queries.
  • MCP Standard: Uses the Model Context Protocol for seamless integration with compatible AI clients.
  • Flexible Deployment: Can be run via CLI (stdio or HTTP), Docker, or integrated directly into MCP server configurations.

Related

  • Project
  • Project
  • Project
  • Project
  • Project