MCP Demo: Model Context Protocol Integration With Openai

🚀 MCP-Demo：Model Context Protocol 集成 OpenAI 的演示

本項目是一個全面的示例，展示了 Model Context Protocol (MCP) 在 .NET 應用中的具體應用。它詳細演示瞭如何創建 MCP 客戶端和服務器，並將其與 OpenAI 的大語言模型（LLM）功能進行集成，為開發者提供了一個實用的參考。

🚀 快速開始

先決條件

• .NET 9.0 SDK
• OpenAI API 密鑰
• 代碼編輯器，如 Visual Studio、VS Code 或 JetBrains Rider

安裝

1. 克隆倉庫

   git clone https://your-repository-url/MCP-Demo.git
   cd MCP-Demo
   

2. 構建解決方案

   dotnet build
   

3. 設置 OpenAI API 密鑰

   cd MCP.LlmIntegration
   dotnet user-secrets set "OpenAI:ApiKey" "your-api-key-here"
   

運行演示

1. 運行 LLM 集成應用程序

   cd MCP.LlmIntegration
   dotnet run
   

2. 應用程序將自動完成以下操作：
   • 啟動 MCP 服務器
   • 連接到 OpenAI API
   • 提供交互式聊天界面
   • 允許通過 OpenAI 使用 MCP 工具進行交互

✨ 主要特性

MCP 服務器

提供了幾個基於函數的實用工具：

• Echo：返回帶有輸入消息的問候
• Add：將兩個數值相加
• GetDateTime：返回當前日期和時間

OpenAI 集成

• 利用 OpenAI API 密鑰連接到 OpenAI API
• 維護對話上下文，確保對話的連貫性
• 從 AI 響應中提取工具調用
• 通過 MCP 服務器執行工具
• 將工具結果返回給用戶

📦 安裝指南

克隆倉庫

git clone https://your-repository-url/MCP-Demo.git
cd MCP-Demo

構建解決方案

dotnet build

設置 OpenAI API 密鑰

cd MCP.LlmIntegration
dotnet user-secrets set "OpenAI:ApiKey" "your-api-key-here"

💻 使用示例

基礎用法

基本計算

您：42 加上 17 等於多少？

AI：我將使用 Add 工具為您計算。
[TOOL_CALL:Add(a=42, b=17)]

結果：42 + 17 = 59

獲取當前日期和時間

您：現在的時間是什麼？

AI：我將使用 GetDateTime 工具為您提供當前時間和日期。
[TOOL_CALL:GetDateTime]

響應：
日期：2023年10月5日
時間：14:30:00

📚 詳細文檔

什麼是 MCP？

Model Context Protocol (MCP) 是一個開放協議，它標準化了應用程序向大型語言模型提供上下文的方式。該協議使得 LLM 與各種數據源和工具之間能夠實現安全集成，併為擴展 LLM 功能提供了標準途徑。

解決方案結構

MCP-Demo/
├── MCP.Server/        # MCP 服務器，帶有自定義工具
├── MCP.Client/        # 簡單的測試客戶端
├── MCP.LlmIntegration/ # OpenAI 集成與 MCP 工具
└── README.md          # 此文檔

架構

• MCP 服務器：負責託管和管理 MCP API 端點，處理工具請求並返回結果。
• OpenAI 集成：使用 OpenAI 的 .NET 客戶端庫與他們的 API 進行交互，並協調工具調用。

擴展項目

若要擴展此項目，可按以下步驟操作：

1. 實現更多自定義工具並與 MCP 服務器集成。
2. 擴展現有工具或創建新的複雜工具以滿足更廣泛的需求。
3. 結合其他 AI 模型和服務來增強功能。

故障排除

如果遇到問題，請參考以下常見解決方案：

• API 錯誤：檢查密鑰是否正確配置，確保網絡連接正常。
• 工具調用失敗：驗證參數是否與工具要求匹配，並確保工具已正確註冊和配置。

📄 許可證

此項目在 MIT License 下許可 - 有關詳細信息，請參閱 LICENSE 文件。

致謝

• Model Context Protocol 創建了協議規範
• OpenAI 提供了 .NET 客戶端庫
• Microsoft 為 .NET 框架和託管庫提供了支持