Travelmcp

🚀 旅行MCP服務器

這是一個使用.NET構建的模型上下文協議（MCP）服務器，可提供包括航班和酒店數據在內的旅行信息。

✨ 主要特性

• GetFlights：搜索可用航班，可選擇按目的地（IATA代碼）進行過濾。
• GetHotels：搜索可用酒店，可選擇按城市進行過濾。
• 使用Contains進行不區分大小寫的過濾。
• 數據從嵌入式JSON文件加載。
• 使用C#記錄進行強類型化。
• 通過標準輸入輸出（JSON - RPC 2.0）自定義實現MCP協議。
• 零外部依賴（除了System.Text.Json）。

📚 詳細文檔

🔧 技術細節

• .NET 8.0：使用現代C#和最小化API。
• System.Text.Json：快速的JSON序列化。
• MCP協議：通過標準輸入輸出自定義實現模型上下文協議。
• JSON - RPC 2.0：用於客戶端 - 服務器通信的標準協議。

📦 安裝指南

前提條件

• .NET 8.0 SDK或更高版本。
• 安裝了GitHub Copilot擴展的Visual Studio Code。

安裝步驟

1. 克隆或導航到項目目錄

   cd TravelMCP
   

2. 恢復依賴項

   dotnet restore
   

3. 構建項目

   dotnet build
   

💻 使用示例

配置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。

使用MCP服務器與GitHub Copilot交互

配置完成後，您可以通過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文檔：代碼註釋用於智能感知。
6. 完整的MCP協議：自定義實現，無外部依賴。
7. 安全的空值處理：可選參數具有默認值。
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

使用.NET和MCP構建