Travelmcp

🚀 Travel MCP Server

このTravel MCP Serverは、.NETを用いて構築されたModel Context Protocol (MCP)サーバーです。航空便やホテルのデータを含む旅行情報を提供します。

✨ 主な機能

• GetFlights：目的地（IATAコード）でのオプションフィルタリングを使って、利用可能な航空便を検索できます。
• GetHotels：都市でのオプションフィルタリングを使って、利用可能なホテルを検索できます。
• Containsを使用した大文字小文字を区別しないフィルタリング
• 埋め込まれたJSONファイルからデータを読み込みます。
• C#のレコードを用いた強い型付け
• 標準入出力を介したカスタムMCPプロトコルの実装（JSON - RPC 2.0）
• 外部依存関係がゼロ（System.Text.Jsonを除く）

🔧 技術詳細

• .NET 8.0：最小限のAPIを持つ最新のC#
• System.Text.Json：高速なJSONシリアル化
• MCP Protocol：標準入出力を介したModel Context Protocolのカスタム実装
• JSON - RPC 2.0：クライアント - サーバー通信の標準プロトコル

📦 インストール

前提条件

• .NET 8.0 SDK以上
• GitHub Copilot拡張機能を搭載したVisual Studio Code

セットアップ手順

1. プロジェクトディレクトリに移動またはクローンする

   cd TravelMCP
   

2. 依存関係を復元する

   dotnet restore
   

3. プロジェクトをビルドする

   dotnet build
   

Visual Studio Codeの設定

VS CodeでMCPを設定する

プロジェクトには事前に設定された.vscode/mcp.jsonファイルが含まれています。これを使用するには：

1. VS Codeでプロジェクトを開く

   code .
   

2. VS Codeを再読み込みする：Ctrl + Shift + Pを押し、Developer: Reload Windowを選択します。

3. Copilotチャットを開く：Ctrl + Alt + Iを押します。

4. ツールが利用可能か確認する：チャットで@workspace /toolsと入力します。

GitHub CopilotでMCPサーバーを使用する

設定が完了すると、VS CodeのGitHub Copilotチャットを通じてサーバーとやり取りできます。

例のプロンプト：

• "Show me all available flights"
• "Find flights to Las Vegas"
• "What hotels are available in San Francisco?"
• "Show me all hotels"

MCPサーバーは統合ツールを通じてデータを提供します。

💻 使用例

利用可能なツール

GetFlights

目的地でのオプションフィルタリングを使って、利用可能な航空便を検索します。

パラメーター：

• to（オプション）：IATAの目的地コード（例："LAS", "SFO", "EZE"）

Copilotでの使用例：

Show me flights to Las Vegas
Find flights with destination SFO

GetHotels

都市でのオプションフィルタリングを使って、利用可能なホテルを検索します。

パラメーター：

• city（オプション）：都市名（例："Las Vegas", "San Francisco", "Buenos Aires"）

Copilotでの使用例：

Show me hotels in San Francisco
Find hotels in Buenos Aires

データ形式

航空便データ

{
  "flight_number": "AA1456",
  "airline": "American Airlines",
  "from": "Miami (MIA)",
  "to": "Las Vegas (LAS)",
  "departure_time": "2025-11-05T09:45:00",
  "arrival_time": "2025-11-05T12:10:00",
  "duration": "5h 25m",
  "price_usd": 289.99
}

ホテルデータ

{
  "city": "Las Vegas",
  "hotel_name": "The Venetian Resort",
  "rating": 4.8,
  "price_per_night_usd": 289.00,
  "address": "3355 S Las Vegas Blvd, Las Vegas, NV 89109, USA",
  "amenities": ["Pool", "Casino", "Spa", "Free WiFi"]
}

プロジェクト構造

TravelMCP/
 Data/
    flights.json      # サンプル航空便データ
    hotels.json       # サンプルホテルデータ
 Mcp/
    McpServer.cs      # MCPサーバーの実装
    Protocol.cs       # JSON - RPCプロトコルの型
 Models/
    Flight.cs         # 航空便データモデル
    Hotel.cs          # ホテルデータモデル
 Program.cs            # アプリケーションのエントリーポイント
 TravelServer.cs       # ビジネスロジックとツールハンドラー
 TravelMCP.csproj      # プロジェクトの設定

テスト

PowerShellスクリプトでテストする

.\test-server.ps1

これにより、サンプルのMCPリクエストがサーバーに送信され、レスポンスが表示されます。

自動テストでテストする

cd Tests
dotnet run

これにより、以下の自動テストが実行されます：

• すべての航空便の取得
• IATAコードによるフィルタリング
• 大文字小文字を区別しない部分検索
• 都市によるホテルのフィルタリング

🔧 技術詳細

1. 不変レコード：データモデルにC#のrecord型を使用しています。
2. 強い型付け：すべてのデータはJSONの逆シリアル化により強く型付けされています。
3. 柔軟なフィルタリング：部分検索にContainsを使用しています。
4. 大文字小文字を区別しない：検索で大文字小文字を区別しません。
5. XMLドキュメント：IntelliSense用のコードコメントがあります。
6. 完全なMCPプロトコル：外部依存関係のないカスタム実装です。
7. 安全なnull処理：デフォルト値を持つオプションパラメーターがあります。
8. JSONスキーマ：ツールの入力スキーマ定義があります。
9. エラーハンドリング：JSON - RPC 2.0に従った適切なエラーレスポンスがあります。

🚀 将来的な改善点

機能面

• 将来の航空便をフィルタリングするための日付検証を追加する
• 価格、評価、所要時間でのソートを実装する
• 航空便とホテルを同時に検索するGetTravelPackage(destination)ツールを追加する
• 追加のフィルター：航空会社、価格範囲、特定の設備
• 座席/部屋の可用性を追加する
• 予約（モック）を実装する

技術面

• 実際の航空便/ホテルAPIに接続する
• 一時的な無効化を伴うデータキャッシュを実装する
• 構造化ロギング（Serilog、NLog）を導入する
• xUnit/NUnitを用いた単体テストを実装する
• MCPプロトコルの統合テストを実装する
• メトリクスとテレメトリを導入する
• 公式リストに対するIATAコードの検証を実装する
• 多言語対応（i18n）を実装する

アーキテクチャ面

• レイヤー（データ、ビジネス、MCP）に分離する
• 依存性注入を導入する
• 外部構成（appsettings.json）を導入する
• Dockerを用いたコンテナ化を行う
• ヘルスチェックを実装する
• 乱用を防止するためのレート制限を実装する

🤝 コントリビューション

これはデモンストレーションプロジェクトです。提案や改善点は大歓迎です！

📚 ドキュメント

• Model Context Protocol Specification
• JSON - RPC 2.0 Specification
• .NET Documentation
• System.Text.Json

📄 ライセンス

MIT

Built with using .NET and MCP