The 12306 MCP Server is a high-performance railway ticket inquiry service that interfaces with China's official 12306 railway system via the Model Context Protocol (MCP).

• Query Train Tickets (query-tickets): Search real-time train availability between stations for a given date, returning schedules, durations, and seat availability across all seat classes.

• Query Ticket Prices (query-ticket-price): Retrieve detailed fare information for trains between two stations, with optional filtering by train number and passenger type (adult/student).

• Search Train Stations (search-stations): Intelligently search for stations using Chinese characters, pinyin, abbreviated pinyin, or three-letter station codes — supports fuzzy search.

• Query Transfer/Connecting Routes (query-transfer): Find optimal transfer plans between two stations, with options to specify a transfer station, seat preferences, and student tickets.

• Get Train Route & Stops (get-train-route-stations): Retrieve the full list of stops for a specific train, including arrival/departure times and dwell times at each station.

• Convert Train Code to Official ID (get-train-no-by-train-code): Convert a human-readable train number (e.g., G1) to the official unique internal identifier, typically needed before querying route stops.

• Get Current Time (get-current-time): Retrieve the current date/time with timezone support and relative date calculations, useful for assisting with date input.

Supports both Stdio mode (for local clients like Claude Desktop) and Streamable HTTP mode (for remote/Docker deployment), implementing the MCP 2025-03-26 standard for seamless AI and automation integration.

Provides containerized deployment of the 12306 MCP Server with pre-built images available on Docker Hub, allowing for isolated and portable execution across different environments

Supports configuration through environment variables using .env files, allowing customization of server settings

Implements an async high-performance API server using FastAPI, enabling real-time train ticket queries with SSE streaming protocol support

Supports installation via Git repository cloning, enabling access to the latest code and version control features

Hosts the source code repository, enabling collaboration, issue tracking and access to the codebase

Includes testing infrastructure for verifying functionality of the 12306 train ticket querying components

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@12306 MCP Server check tickets from Beijing to Shanghai for tomorrow"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.