mcp-server-12306

Overview

The MCP Server 12306 is a Python-based backend that integrates with China's official 12306 railway booking system through the Model Context Protocol. It provides comprehensive train ticket information including seat availability, station details, transfer options, and pricing. The server supports both stdio and HTTP modes for flexible deployment, with FastAPI ensuring high performance and quick response times. It's designed specifically for AI assistants and automation systems that need access to railway data.

Try asking AI

After installing, here are 3 things you can ask your AI assistant:

• query_tickets

  余票/车次/座席/时刻一站式查询

  Try:查询北京到上海的火车票Try:显示今天下午出发到广州的列车
• query_ticket_price

  实时查询各车次票价信息

  Try:查询G123次列车的票价Try:显示北京到高铁二等座的价格
• search_stations

  车站模糊搜索，支持中文/拼音/简拼

  Try:查找北京站Try:搜索shTry:find beijing west station
• get_station_info

  获取车站详情（名称、代码、地理等）

  Try:获取北京南站信息Try:显示上海虹桥站的详细信息
• query_transfer

  一次中转换乘方案，自动拼接最优中转

  Try:查询广州到成都的中转方案Try:找从北京到乌鲁木齐的最佳换乘路线
• get_train_route_stations

  查询指定列车经停站及时刻表

  Try:显示G123次列车的经停站Try:查询T7次火车的沿途站点
• get_current_time

  获取当前时间与相对日期，帮助用户准确选择出行日期

  Try:现在是什么时间Try:显示明天的时间Try:获取当前UTC时间

Comparable tools

Installation

{
  "mcpServers": {
    "12306": {
      "command": "uvx",
      "args": ["mcp-server-12306"]
    }
  }
}

{
  "mcpServers": {
    "12306": {
      "command": "pipx",
      "args": ["run", "--no-cache", "mcp-server-12306"]
    }
  }
}

git clone https://github.com/drfccv/mcp-server-12306.git
cd mcp-server-12306
uv sync
uv run python scripts/start_server.py

{
  "mcpServers": {
    "12306": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Compare mcp-server-12306 with