freemcplab / Annuaire / Playground / 12306-mcp

● Communauté Joooook ⚡ Instantané

12306-mcp

Name: 12306-mcp MCP Server
Author: Joooook

Query China's 12306 railway tickets via AI — search trains, check availability, and plan routes with natural language.

12306-mcp is an MCP server that connects AI assistants to China's official 12306 railway system. It supports ticket availability queries, train filtering, transit stop lookups, and multi-leg transfer planning. Runs via npx, Docker, or HTTP mode for flexible deployment.

▶ Voir la démo 📦 Installer 💡 Cas d'usage

Pourquoi l'utiliser

Fonctionnalités clés

Real-time ticket availability from China's official 12306 railway API
Train filtering by seat type, departure time, and preferences
Transit stop and route information for any train number
Transfer route planning for multi-leg journeys
Supports stdio and HTTP transport modes

Démo en direct

Aperçu en pratique

12306-mcp-2.replay ▶ prêt

0/0

Installer

Choisissez votre client

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

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

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : 12306-mcp

How to find the cheapest train between two cities with 12306-mcp

👤 Travelers planning trips within China ⏱ ~5 min beginner

Quand l'utiliser : You need to compare train options between two Chinese cities and find the best deal.

Prérequis

12306-mcp server running — npx -y 12306-mcp

Déroulement

Search for available trains

Search for trains from Beijing to Shanghai tomorrow. Show me all available options with prices and seat types.✓ Copié

→ A table of trains with departure times, durations, seat classes, and prices
Filter by preference

Which of these has second-class seats available and arrives before 6pm?✓ Copié

→ Filtered list matching the criteria

Résultat : A clear comparison of train options to make a booking decision.

Pièges

Station names must match 12306's database exactly — Use the station search tool first to confirm the correct station name

Plan a multi-leg train journey with transfers using 12306-mcp

👤 Travelers heading to cities without direct trains ⏱ ~10 min beginner

Quand l'utiliser : No direct train exists between your origin and destination.

Prérequis

12306-mcp server running — npx -y 12306-mcp

Déroulement

Query transfer options

I need to get from Chengdu to Lhasa by train. Find me transfer routes with the shortest total travel time.✓ Copié

→ One or more transfer itineraries with intermediate stations and connection times
Check availability on each leg

Check ticket availability for each leg of the recommended route on March 15.✓ Copié

→ Seat availability for both legs of the journey

Résultat : A complete multi-leg itinerary with confirmed availability.

Pièges

Tight transfer windows may cause missed connections — Ask Claude to filter for transfers with at least 2 hours between trains

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

12306-mcp-2 + fetch

Combine train search with web fetch to check weather at your destination before booking

Find me a train from Shanghai to Hangzhou this Saturday, and check the weekend weather forecast for Hangzhou.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
query_tickets	from: str, to: str, date: str	Search for available train tickets between two stations	1 API call
search_stations	keyword: str	Look up station names and codes by keyword	1 API call
query_transfer	from: str, to: str, date: str	Find transfer routes when no direct train exists	1 API call
get_train_route_stations	train_no: str	Get all stops along a specific train's route	1 API call

Coût et limites

Coût d'exécution

Quota d'API: Depends on 12306 public API rate limits — typically sufficient for personal use
Tokens par appel: 200–800 tokens per query
Monétaire: Free — queries the public 12306 API
Astuce: Batch station lookups before running ticket queries to avoid redundant calls.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : No credentials required — uses public 12306 API endpoints

Sortie de données : All calls go to 12306.cn official API endpoints

Dépannage

Erreurs courantes et correctifs

Station name not found

Use the station search tool to find the exact name. Chinese station names must match the 12306 database — try both simplified Chinese and pinyin.

Vérifier : Search for the station by keyword first

No trains found for the given date

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

Vérifier : Try a date within the next 15 days

Connection timeout

The 12306 API can be slow during peak booking times (e.g., Spring Festival). Retry after a few minutes.

Vérifier : Test with a simple station search to confirm connectivity

Alternatives

12306-mcp vs autres

Alternative	Quand l'utiliser	Compromis
mcp-server-12306	You want a Python-based alternative with FastAPI backend and additional price query tools	More features (price queries, HTTP streaming) but requires Python/uv setup

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills