MCPプロトコルベースの高性能12306チケット照会バックエンド、AI自動化シーン対応

MCP Server 12306

MCPプロトコルに基づく高性能の12306鉄道切符照会バックエンドで、残り切符、駅、停車駅、乗り換え照会、およびインテリジェントな時間ツールをサポートし、AI/自動化シナリオに適合します。

旅行と交通開発者ツール #鉄道切符照会 #MCPプロトコル #インテリジェントな乗り換え #時間ツール .Python

スコア : 2ポイント

ダウンロード数 : 2

更新時間 : 2025-07-24

12306 MCPサーバーとは？

12306 MCPサーバーは、Model Context Protocol (MCP)に基づく高性能の鉄道切符照会バックエンドサービスです。公式の12306のリアルタイム残り切符、列車番号、座席、時刻、乗り換えなどの情報を提供し、インテリジェントな時間ツールをサポートしており、AI/自動化/インテリジェントアシスタントなどのシナリオに適しています。

12306 MCPサーバーをどのように使用するか？

ユーザーは簡単な設定とAPIの呼び出しにより、このサーバーが提供する機能を使用できます。ローカルデプロイまたはDockerデプロイ方式を選択でき、HTTPインターフェイスを通じて必要な情報を取得できます。

適用シナリオ

このサーバーは、鉄道切符情報照会が必要なさまざまなシナリオに適用されます。これには、AIアシスタントの統合、自動化システム、インテリジェントな旅行アプリ、駅情報管理などが含まれます。

主な機能

リアルタイム残り切符照会全国範囲の鉄道切符のリアルタイム残り切符情報を提供し、列車番号、座席タイプ、残り数量を含みます。

駅情報管理全国の駅の曖昧検索をサポートし、漢字、ピンイン、または略ピンインで検索できます。

列車の停車駅照会指定された列車の停車駅と時刻表情報を提供し、ユーザーが旅程の詳細を把握できるようにします。

乗り換え方案照会一度の中間乗り換え方案の自動結合をサポートし、ユーザーに最適な乗り換え提案を提供します。

インテリジェントな時間ツール現在時刻と相対日付の計算機能を提供し、ユーザーが正確に旅行日を選択できるように支援します。

利点と制限

利点

高性能非同期アーキテクチャで、秒単位の応答をサポート

MCP 2025 - 03 - 26標準に互換性があり、将来の技術開発に適合

AI/自動化システムへの統合が容易

曖昧検索、乗り換え方案など、さまざまな照会方式をサポート

詳細なドキュメントとサンプルを提供し、開発者がすぐに使い始められるようにする

制限

公式データの集約と転送のみを提供し、データを保存または改竄しません。

12306公式インターフェイスの可用性に依存します。

関連する法律、規制、および12306の使用規定を遵守する必要があります。

使い方

プロジェクトをクローンする

GitHubから12306 MCPサーバープロジェクトをローカルにクローンします。

依存関係をインストールする

uvツールを使用して、プロジェクトに必要な依存パッケージをインストールします。

駅情報を更新する

全国の駅情報データベースを更新するためにスクリプトを実行します。

サーバーを起動する

uvを使用して起動スクリプトを実行し、FastAPIサービスを起動します。

APIにアクセスする

ブラウザまたはPostmanでhttp://localhost:8000/mcpインターフェイスにアクセスし、情報照会を開始します。

使用例

残り切符情報を照会するユーザーは北京から上海までの残り切符状況を照会したいと思っています。

駅を検索するユーザーは「北京南駅」の詳細情報を検索したいと思っています。

乗り換え方案を照会するユーザーは広州から成都までの旅行を計画しており、一度の乗り換えの最適な方案を取得したいと思っています。

よくある質問

商用利用はできますか？

アカウント登録が必要ですか？

エラーが発生した場合はどうすればいいですか？

カスタム設定は可能ですか？

🚄 12306 MCP Server

12306 MCP Serverは、Model Context Protocol (MCP)に基づく高性能の鉄道切符照会バックエンドです。公式12306の残り切符、駅、経由駅、乗り換え照会や、スマートな時間ツールをサポートしており、AI/自動化/スマートアシスタントなどのシーンに適合しています。インターフェースが使いやすく、簡単に統合でき、すぐに使えます。

🚀 クイックスタート

環境要件

Python 3.10+
uv（推奨パッケージマネージャー）

ローカルでのワンクリックデプロイ

# プロジェクトをクローンする
git clone https://github.com/drfccv/mcp-server-12306.git
cd mcp-server-12306

# 依存関係をインストールする
uv sync

# 駅情報を更新する（最初に実行する必要があります）
uv run python scripts/update_stations.py

# サーバーを起動する
uv run python scripts/start_server.py

Dockerデプロイ

# すでに構築されたイメージを直接取得する
 docker pull drfccv/mcp-server-12306:latest

# コンテナを実行する（ポート8000をマッピングする）
 docker run -d -p 8000:8000 --name mcp-server-12306 drfccv/mcp-server-12306:latest

カスタム開発やローカルでの修正後にパッケージ化する場合は、以下のコマンドで独自にイメージを構築できます。
docker build -t drfccv/mcp-server-12306:latest .

設定

.env.exampleを.envにコピーし、必要に応じて変更します。

cp .env.example .env

✨ 主な機能

リアルタイムの残り切符/列車番号/座席/時刻/乗り換えのワンストップ照会
全国の駅情報管理と曖昧検索
公式の経由駅、一度の乗り換え案を完全にサポート
スマートな時間ツールで、相対日付の計算をサポートし、日付入力ミスを防ぐ
Streamable HTTP伝送プロトコルで、MCP 2025-03-26標準をサポート
FastAPIの非同期高性能で、秒単位の応答
MCP標準で、AI/自動化シーンに即座に使用可能

💻 使用例

基本的な使用法

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

サポートされるメインフローツール

ツール名	典型的なシーン/機能説明
query_tickets	残り切符/列車番号/座席/時刻のワンストップ照会
search_stations	駅の曖昧検索、中国語/ピンイン/簡略ピンインをサポート
get_station_info	駅の詳細情報（名称、コード、地理など）を取得する
query_transfer	一度の乗り換え案を自動的に最適な乗り換えに結合する
get_train_route_stations	指定列車の経由駅と時刻表を照会する
get_current_time	現在の時間と相対日付を取得し、ユーザーが正確に出発日を選択できるようにする

📚 ドキュメント

このプロジェクトのすべてのメインフローツールの詳細な機能、実装方法、使用方法は、/docsディレクトリに収録されています。

query_tickets.md — 残り切符/列車番号/座席/時刻のワンストップ照会
search_stations.md — 駅の曖昧検索
get_station_info.md — 駅の詳細情報を取得する
query_transfer.md — 一度の乗り換え案
get_train_route_stations.md — 列車の経由駅を照会する
get_current_time.md — 現在の時間と相対日付を取得する

各ドキュメントには以下が含まれています。

ツールの機能説明
実装方法
リクエストパラメータと返却例
典型的な呼び出し方法

二次開発や統合を行う場合は、対応するツールのドキュメントを読むことをおすすめします。

🔧 技術詳細

ディレクトリ構造

src/mcp_12306/    # メインソースコード
  ├─ server.py    # FastAPIのメインエントリー
  ├─ services/    # ビジネスロジック（切符/駅/HTTP）
  ├─ models/      # データモデル
  ├─ utils/       # ツールと設定
scripts/          # 起動とデータスクリプト

テスト

uv run pytest

📦 インストール

イメージレポジトリ：drfccv/mcp-server-12306

イメージを取得する：

docker pull drfccv/mcp-server-12306:latest

イメージを実行する：

docker run -d -p 8000:8000 --name 12306-mcp-server drfccv/mcp-server-12306:latest

📄 ライセンス

MIT License

⚠️ 重要提示

⚠️ 重要提示

このプロジェクトは学習、研究、技術交流のためのみに使用され、商業目的での使用は厳禁です。このプロジェクトは12306の公式データを保存、改ざん、伝播することはなく、公式の公開インターフェイスのスマートな集約と転送のみを行います。このプロジェクトの使用によって生じるすべての結果（アカウントの凍結、データの異常、法的なリスクなどを含むがこれらに限定されない）は、使用者自身が責任を負い、プロジェクトの作者は一切の責任を負いません。中国の法律と規制および12306の公式規定を遵守し、適切かつ合法的に使用してください。