MCP Sncf

🚀 SNCF 跨運輸協調サーバー

本プロジェクトは、SNCF（フランス国家鉄道公社）の複合輸送サービスに強力な技術インフラを提供することを目的としています。このシステムはClaude AIと深度に統合されており、列車、バス、その他の交通手段の行程をスマートに計画し、リアルタイム情報と介入機能を提供します。

🚀 クイックスタート

このサーバーを使用することで、SNCFの複合輸送サービスを効率的に管理できます。以下に基本的な使い方を説明します。

✨ 主な機能

1. 列車行程計画

• plan_journey_by_city_names ツールを使用して、都市名に基づいて最適な列車路線を計画します。
• 複雑な乗り換えニーズに対応し、リアルタイムの乗車券情報を提供します。

2. 駅情報照会

• 特定の駅の基本情報、利用可能な交通手段（列車、バス、路面電車など）、周辺施設を照会します。
• get_station_details ツールで詳細情報を取得できます。

3. 列車ダイヤ照会

• get_station_schedule ツールを使用して、特定の駅の予定列車と予定外列車を確認します。
• リアルタイム更新とプラットホーム詳細表示に対応しています。

4. サービス介入とトラブルシューティング

• 列車サービスまたは設備の介入や中断を確認し、報告します。
• report_service_interruption ツールで問題を報告できます。

5. 多言語対応

• 英語、フランス語、その他のヨーロッパ言語を含む複数の言語での行程計画とレポートをサポートします。

6. サードパーティサービスの統合

• バス、飛行機などの他の交通手段とのデータ交換をサポートします。

7. 自動介入

• リアルタイムデータに基づいてサービス中断を自動検出し、報告します。
• カスタマイズ可能な通知システムを提供します。

📦 インストール

インストール手順

1. 最新バージョンのSNCF複合輸送協調サーバー（MCP Server）をダウンロードし、インストールします。
2. SNCFが提供するAPIキーをシステム環境変数に追加します。
3. train_stations_europe.csv ファイルをサーバーディレクトリにコピーし、権限設定を正しく行います。

サーバー設定

• APIキー：初期化時に有効なSNCF APIキーを指定します。
• CSV駅データ：デフォルトではヨーロッパの鉄道駅データベースを使用し、カスタム拡張も可能です。
• ログ設定：操作とエラーを追跡するために詳細なログ記録を有効にします。

💻 使用例

基本的な使用法

例1：列車行程の計画

# サーバーの初期化
mcp_server = SNCFMCP_Server(api_key="your_api_key")

# パリからマルセイユまでの行程を計画する
journey = mcp_server.plan_journey(from_city="Paris", to_city="Marseille")
print(journey.details)

例2：駅情報の照会

# サーバーの初期化
mcp_server = SNCFMCP_Server(api_key="your_api_key")

# リヨン駅の基本情報を照会する
station_info = mcp_server.get_station_details(station_id=" Lyon ")
print(station_info.facilities)

📚 詳細ドキュメント

トラブルシューティング

一般的な問題

1. API接続エラー：
   • APIキーが有効で正しく設定されていることを確認してください。
2. データベースエラー：
   • CSVファイルの整合性を確認し、権限設定が正しいことを確認してください。

エラー解決ガイド

• サーバーログを確認して具体的なエラー情報を取得します。
• --verbose フラグを使用して詳細なデバッグモードを有効にします。

貢献ガイド

貢献の方法

1. 問題を報告するか、改善提案をするためにissueを提出します。
2. コードの修正や機能拡張を行うためにPull Requestを提出します。
3. ドキュメントの作成とローカライズ作業に参加します。

📄 ライセンス

本プロジェクトはMITライセンスの下で提供されています。詳細な条項については、LICENSEファイルを参照してください。

👏 謝辞

以下の人員と機関の支援に感謝します。

• SNCF開発チーム
• Claude AIチーム
• 世界のオープンデータコミュニティ