12306-mcp: MCPプロトコルに基づく乗車券照会サーバー

12306-mcp 是一个基于 モデル・コンテキスト・プロトコル (エムシーピー) 的火车票查询服务器，专为查询中国铁路12306票务信息设计。它提供简单易用的 API 接口，让用户或开发者通过程序快速获取实时火车票信息。项目托管在 GitHub，由开发者 Joooook 创建，旨在为 AI 助手或自动化工具提供高效的票务查询支持。服务器支持查询余票、列车信息、经停站和中转方案，适合需要快速获取票务数据的场景。项目仅用于学习，强调不存储或篡改官方数据，注重接口的简洁性和实用性。

機能一覧

• 12306列車のチケット情報（残席数、列車本数、座席タイプ、時刻表など）をご確認ください。
• 列車情報のフィルタリング、時間、運賃、列車タイプによるフィルタリングをサポート。
• 列車の停車駅情報、通過都市、停車時間を検索できます。
• トランジットの問い合わせをサポートし、ワンストップ・インターチェンジ・プログラムのアドバイスを提供する。
• AIアシスタントや自動化プログラムに簡単に統合できるシンプルなAPIインターフェースを提供。
• 全国の放送局情報のあいまい検索に対応し、放送局を素早く見つけることができる。

ヘルプの使用

設置プロセス

12306-mcpサーバーを使用するには、以下の手順に従って、ローカルまたはサーバー上に配置してください：

1. プロジェクトコードの複製
   Gitコマンドを使ってプロジェクトのソースコードをダウンロードする：

   git clone https://github.com/Joooook/12306-mcp.git
   

2. 依存関係のインストール
   プロジェクト・ディレクトリに移動し、Node.jsの依存関係をインストールする：

   cd 12306-mcp
   npm i
   

3. プロジェクトの構築
   ビルドコマンドを実行して実行ファイルを生成する：

   npm run build
   

4. サーバーの起動
   以下のコマンドを実行してサーバーを起動する：

   node ./build/index.js
   

5. MCPサーバーの設定
   12306-mcpをMCPプロトコルをサポートするシステムに統合する必要がある場合は、コンフィギュレーション・ファイルに以下を追加してください：

   {
   "mcpServers": {
   "12306-mcp": {
   "command": "npx",
   "args": ["-y", "12306-mcp"]
   }
   }
   }
   

   コンフィギュレーション・ファイルのパスは通常、MCPプロトコルがサポートするクライアントまたはプラットフォームにあります。

使用方法

デプロイ後、12306-mcpは開発者やAIアシスタントがHTTPリクエストで呼び出せるAPIインターフェースのセットを提供する。以下に主な機能の動作フローを示す：

1.乗車券情報の検索

ユーザーはAPIを通じてリクエストを送信し、指定した日付、出発地、目的地の列車チケット情報を照会できる。例えば、北京から上海までの列車のチケットを検索する：

• APIリクエスト例::

  GET /tickets?from=Beijing&to=Shanghai&date=2025-07-22
  

• リターンデータJSON形式：列車本数、出発時刻、到着時刻、運賃、残枚数など。
• 手続き::
  1. 出発地、目的地、日付を決定する。
  2. HTTPクライアント（Postmanなど）やコードを使ってGETリクエストを送る。
  3. 返されたJSONデータを解析して、利用可能な旅行と運賃を取得します。
• 銘記する出発地と目的地は12306の正式な駅名またはコードを使用する必要があります。

2.列車情報のフィルタリング

高速列車のみ、夜行列車のみなど、利用者のニーズに合わせて列車を絞り込むことができる：

• APIリクエスト例::

  GET /tickets?from=Beijing&to=Shanghai&date=2025-07-22&type=highspeed
  

• 手続き::
  1. リクエストにフィルターパラメーターを追加する。 type=highspeed(高速鉄道）または time=night(夜に）。
  2. サーバーは対象となる旅行のリストを返す。
  3. さらに、運賃や期間で並べ替えることもできる。

3.停車駅の検索

特定の列車の停車駅と停車時間を問い合わせる：

• APIリクエスト例::

  GET /train/stops?trainNo=G123
  

• リターンデータJSON形式：通過駅名、到着時刻、停車時刻。
• 手続き::
  1. 対象の列車番号を取得する（例：G123）。
  2. 停車駅のリストを入手するにはリクエストを送信してください。
  3. 地図ツールと組み合わせることで、旅行のヒントを作成したり、通過する都市の旅程を計画したりすることができる。

4.トランジットに関する問い合わせ

直通列車がない路線については、サーバーが乗り換えの選択肢を提供する：

• APIリクエスト例::

  GET /transfer?from=Xian&to=Zhengzhou&date=2025-07-22
  

• リターンデータお勧めの途中降機地、乗り換え時間、総所要時間。
• 手続き::
  1. 出発地、目的地、日付を入力してください。
  2. 武漢での具体的な列車本数や乗り換え時間など、サーバーによる往復トランジット・プログラム。
  3. 利用者は、総所要時間または運賃に基づいて最適なオプションを選択することができる。

5.ファジー検索ステーション

完全な情報を検索するために駅名の一部を入力することをサポートしています：

• APIリクエスト例::

  GET /stations?name=Hang
  

• リターンデータ杭州」駅と「杭州東」駅の詳細情報。
• 手続き::
  1. 駅名の一部をピンインまたは漢字で入力します。
  2. サーバーは一致するステーションのリストを返す。
  3. チケット照会に使用する正しい駅コードをリストから選択する。

ほら

• データソースすべてのチケットデータは公式12306インターフェイスから送られ、サーバーは集計と転送を行うだけで、データを保存することはありません。
• 使用リスク頻繁なリクエストは12306のアンチクライミング機構を作動させる可能性があります。
• 開発サポート機能リクエストはGitHubで受け付けています。

アプリケーションシナリオ

1. AIアシスタントの統合
   12306-mcpはAIアシスタント（インテリジェントなチャットボットなど）に組み込むことができ、ユーザーが音声やテキストで「明日上海から杭州までの列車のチケット」と入力すると、アシスタントがAPIを呼び出してリアルタイムのチケット情報を返し、列車の運行本数や運賃を迅速に提供する。
2. 旅行計画ツール
   開発者は、12306-mcpを旅行計画アプリケーションに統合し、停車駅情報を組み合わせて、旅行中の都市の旅行ガイドを生成することができる。例えば、北京から広州への列車を検索すると、武漢の観光スポットが提案される。
3. 自動発券照会
   企業は、12306-mcpを使用して、旅行管理やチケット代理店のシナリオに適した、リアルタイムで特定のルート上の残りのチケットを追跡する自動化されたチケット監視ツールを開発することができます。
4. 教育・研究
   学生や開発者は、12306-mcpを使ってMCPプロトコルの実装を学び、APIを通じてサードパーティーのデータを集約する方法を学ぶことができる。

品質保証

1. 12306-Mcpは有料ですか？
   このプロジェクトは完全にオープンソースで、無料で使用でき、GitHubでホストされており、サーバーの自己デプロイだけが必要である。
2. チケットのリアルタイム更新をサポートしていますか？
   はい、正確なチケット情報を確保するため、サーバーは公式12306インターフェイスを通じてリアルタイムのデータを取得します。
3. 12306のクロール防止機構が作動しないようにするには？
   短時間での高頻度のリクエストを避けるため、適度なリクエスト間隔（例えば、1分間に5回以下）を設定することを推奨する。
4. 携帯電話で直接使用できますか？
   現在のところ、コンピューターやサーバー上に配置する必要があり、携帯電話はAPIクライアントを介してアクセスするか、将来的なモバイル対応を待つことになる。
5. APIを呼び出すためにサポートされているプログラミング言語は何ですか？
   APIは標準HTTPプロトコルを使用し、HTTPリクエストをサポートするあらゆる言語（PythonやJavaScriptなど）から呼び出すことができる。