DM

drfccv/mcp-server-12306

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

415 stars 59 forks 品質 82 トレンド 28MIT

12306 MCPサーバーは、Model Context Protocol(MCP)に基づく高性能な列車チケットクエリバックエンドシステムです。標準化されたインターフェースを通じて、チケットの入手可能性問い合わせ、駅情報、列車停車、乗り換えソリューションなどのコア機能を含む公式のリアルタイムデータサービスを提供します。

概要

MCPサーバー12306は、Model Context Protocol(MCP)に基づく高性能な列車チケット照会サービスです。公式の12306チケットの入手状況、チケット価格、駅、停留所、乗り換え照会、インテリジェントタイムツールをサポートしています。AI、自動化、インテリジェントアシスタントシナリオに対応しており、箱からすぐに使えます。 - 残りチケット・列車番号・座席・時刻・乗り換えのリアルタイムワンストップ検索 - 全国駅情報管理・ファジー検索、中国語、ピンイン、簡体字ピンイン、3文字コード対応 - 公式停車駅および乗り換えソリューションの完全サポート - 各列車のリアルタイム運賃情報 - タイムゾーンとタイムスタンプ対応のインテリジェントタイムツール - デュアルトランスミッションモード:Stdio(Claudeデスクトップ推奨) |ストリーミングHTTP(リモート展開) - MCP 2025-03-26標準、AI/自動化シナリオにプラグアンドプレイ このプロジェクトは2つのランタイムモードをサポートしています。1.: Claude DesktopなどのローカルMCPクライアントに適し(推奨)2. : リモート展開やSSE/POST経由でアクセスに適しています。 このモードでは、MCPサーバーはネットワークポートを占有することなく、標準的な入出力を通じてクライアントと通信します。 このモードでは、サーバーはMCP SSEおよびPOSTのやり取りをサポートするWebサービス(デフォルトポート8000)を開始します。 このプロジェクトの主要なプロセスツールのすべての詳細な機能、実装、使用方法はすべて /docs ディレクトリに含まれています。 各文書には以下が含まれます:- ツールの説明 - 実装手法 - リクエストパラメータと返還例 - 典型的な呼び出しパターン - このプロジェクトは学習、研究、技術交流のみを目的としており、商業利用は厳しく禁止されています。- このプロジェクトは公式の12306データを保存、改変、または配布しません。あくまで公式のパブリックインターフェースの知的な集約と転送のみを目的としています。- 本プロジェクトの利用に伴う結果(アカウント禁止、データ異常、法的リスクなどを含むがこれらに限定されません)はユーザーの責任であり、プロジェクトの作者は一切の責任を負いません。- 中国の法律および規則および公式の12306規則を遵守し、合理的かつ準拠に従って使用してください。

概要(AI 翻訳)

モデルコンテキストプロトコル(MCP)ベースの12306列車チケット照会サービス

6つの主要なクエリ機能をサポートしています:残りチケット/運賃/駅/停留所/乗り換え/時間。箱からすぐに使える、AIアシスタント、自動スクリプト、スマート端末、その他のシナリオに適しています。


📑 目次

  • ✨ 機能的特徴
  • 🚀 早く始めて
  • 環境要件
  • 方法1:スタンドモード(ローカルクライアントに推奨)
  • 方法2:ストリーミング可能なHTTPモード(リモート展開)
  • 方法3:Docker展開
  • 🛠️ ツール概要
  • ⚙️ 構成項目
  • 🏗️ プロジェクト構成
  • 🧑 💻 開発ガイド
  • 📚 詳細な文書化
  • ⚠️ 免責事項
  • 📄 ライセンス

✨ 機能的特徴

カテゴリ 能力
🎫 残り切符照会残り切符/列車番号/座席/時刻のワンストップ検索、列車番号によるフィルタリング支援
💰 運賃照会各列車および座席タイプ(ビジネスクラス→非座席、フルカバレッジ)の運賃をリアルタイムで表示
🏙️ 駅検索全国で3,382+局があり、中国語/ピンイン/簡体字ピンイン/3文字コードの曖昧検索に対応しています
🔄 トランジット中の転送公式の転送計画は自動的にルートをページ分けし記録し、ルート全体と待ち時間が返されます
🛤️ 停車問い合わせ 指定列車の全停車駅および到着・出発時刻を確認してください
🕐 タイムツール任意のタイムゾーンの現在の時刻と相対日付を取得し、旅行日の選択を助ける
🔌 デュアル伝送モード Stdio(ローカル) |ストリーミング可能なHTTP(リモート)、同じコアインスタンスを共有する
🔄 プロトコル自動交渉 MCP SDK v2をベースに、ハンドシェイク時代(2025-11-25)およびモダンプロトコル(2026-07-28)と自動互換性があります

🚀 早く始めよう

環境要件

依存 リクエスト
Python >= 3.10, 💡 推荐使用 uv’:環境隔離、迅速なインストール、ファイル管理依存バージョン。

方法1:スタンディオモード(ローカルクライアント推奨)

MCPサーバー>標準的な入出力を通じてクライアントと通信し、ネットワークポートを占有しない、Claude DesktopやCursorなどのローカルMCPクライアントに適しています。

設置:

クライアント構成(例:claude_desktop_config.json):

その他の設置方法(クリックで展開)

pipx:

ローカルソースコード(開発者デバッグ):

方法2:ストリーミング可能なHTTPモード(リモート展開)

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

インストール

uvx mcp-server-12306
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

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