freemcplab / Verzeichnis / Playground / mcp-server-12306

● Community drfccv ⚡ Sofort

mcp-server-12306

Name: mcp-server-12306 MCP Server
Author: drfccv

High-performance Python MCP server for 12306 — real-time tickets, prices, station search, train routes, and transfer planning.

mcp-server-12306 is a FastAPI-based MCP server providing real-time data from China's 12306 railway system. It offers 7 tools for ticket queries, price lookups, station search (Chinese/pinyin/abbreviation), train route stops, transfer planning, and time utilities. Supports both stdio (Claude Desktop) and Streamable HTTP modes, with Docker deployment and sub-second response times.

▶ Demo ansehen 📦 Installieren 💡 Anwendungsfälle

Warum nutzen

Hauptfunktionen

7 MCP tools covering tickets, prices, stations, routes, and transfers
Smart station search supporting Chinese characters, pinyin, and abbreviations
Real-time fare information for specific trains and seat classes
Dual protocol: stdio for Claude Desktop, Streamable HTTP for remote deployment
FastAPI-based with sub-second response times

Live-Demo

In der Praxis

mcp-server-12306-2.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-12306-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/drfccv/mcp-server-12306"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-12306-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/drfccv/mcp-server-12306"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-server-12306-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/drfccv/mcp-server-12306"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-12306-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/drfccv/mcp-server-12306"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-server-12306-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/drfccv/mcp-server-12306"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-server-12306-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/drfccv/mcp-server-12306"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add mcp-server-12306-2 -- TODO 'See README: https://github.com/drfccv/mcp-server-12306'

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: mcp-server-12306

How to compare train ticket prices for a journey with mcp-server-12306

👤 Budget-conscious travelers in China ⏱ ~5 min beginner

Wann einsetzen: You want to find the cheapest option for your train journey.

Voraussetzungen

mcp-server-12306 running — uvx mcp-server-12306 or Docker: docker run -p 8000:8000 drfccv/mcp-server-12306:latest

Ablauf

Search tickets with prices

Query tickets from Beijing to Guangzhou for tomorrow. Show all available trains with prices for each seat class.✓ Kopiert

→ Table of trains with departure times, durations, and prices per seat class
Get detailed pricing

Show me the detailed pricing for train G79, including all seat types.✓ Kopiert

→ Complete fare breakdown for the specific train

Ergebnis: Clear price comparison to choose the best value train.

Fallstricke

Prices may vary by date and availability — Check availability alongside prices — cheap seats sell out first

Plan a multi-city train trip across China

👤 Tourists planning a scenic route through multiple Chinese cities ⏱ ~15 min beginner

Wann einsetzen: You want to visit several cities and need to plan the train connections.

Voraussetzungen

mcp-server-12306 running — uvx mcp-server-12306

Ablauf

Search stations

Search for the main train stations in Shanghai, Hangzhou, and Suzhou. Show me the station codes.✓ Kopiert

→ Station names and codes for each city
Plan the route

Find the fastest train connections for: Shanghai → Hangzhou → Suzhou → back to Shanghai, spending one day in each city. Show departure times and durations.✓ Kopiert

→ Complete itinerary with train numbers and times

Ergebnis: A multi-city itinerary with all train connections planned.

Fallstricke

Small cities may only have one station — Use the station search to confirm available stations before planning

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mcp-server-12306-2 + fetch

Check weather at your destination alongside train schedules

Find trains from Beijing to Chengdu this weekend and check the weather forecast for Chengdu.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
query_tickets	from: str, to: str, date: str	Search for available train tickets	1 API call
query_ticket_price	train_no: str, from: str, to: str, date: str	Get detailed pricing for a specific train	1 API call
search_stations	keyword: str	Search stations by name, pinyin, or abbreviation	1 API call
get_station_info	station_code: str	Get detailed station metadata	1 API call
query_transfer	from: str, to: str, date: str	Find optimal transfer routes	1 API call
get_train_route_stations	train_no: str	Get all stops along a train route	1 API call
get_current_time	none	Get current time for relative date calculations	0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Subject to 12306 public API rate limits
Tokens pro Aufruf: 200–800 tokens per query
Kosten in €: Free — uses public 12306 API
Tipp: Use station search to confirm names before querying tickets to avoid wasted calls.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: No credentials required

Datenabfluss: All calls to 12306.cn official API

Fehlerbehebung

Häufige Fehler und Lösungen

No tickets found

12306 sells tickets 15 days in advance. Verify your date is within the booking window.

Prüfen: Try today's date to confirm connectivity

Station not recognized

Use search_stations first with pinyin or Chinese to find the exact station name.

Prüfen: search_stations with a broader keyword

Timeout during peak hours

12306 API is slow during peak ticket sales (holidays, Spring Festival). Retry after a few minutes.

Prüfen: Test with a simple station search

Alternativen

mcp-server-12306 vs. andere

Alternative	Wann stattdessen	Kompromiss
12306-mcp	You prefer a JavaScript/npx-based server with simpler setup	Simpler install but fewer features (no price queries or HTTP streaming)

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen