MCP With Semantic Kernel

🚀 集成模型上下文協議（MCP）工具與語義內核：分步指南

本項目展示瞭如何將模型上下文協議（MCP）工具與微軟語義內核集成，從而實現AI模型與外部數據源或工具的無縫交互。按照本指南操作，您將學會連接MCP服務器、把MCP工具轉換為語義內核函數，並利用大型語言模型（LLMs）進行函數調用，且這一切都在一個可複用、可擴展的框架中完成。

🚀 快速開始

什麼是模型上下文協議（MCP）？

模型上下文協議（MCP） 是一種開放標準協議，旨在規範應用程序為AI模型提供上下文的方式。它就像一個通用連接器，能讓大型語言模型（LLMs）以統一的方式與各類數據源（如API、數據庫或服務）進行交互。可以把MCP想象成一座橋樑，它增強了AI的互操作性、靈活性和上下文理解能力。

在本項目中，我們利用MCP來公開語義內核可使用的工具，以實現AI驅動的工作流，並與現實世界的應用程序（如自動化、數據檢索或系統集成）相結合。

為什麼將語義內核與MCP結合使用？

Microsoft語義內核 是一個強大的SDK，它簡化了構建AI代理和編排複雜工作流的過程。通過集成MCP工具，您可以：

• 藉助MCP服務器擴展語義內核的功能。
• 使LLMs能夠根據用戶提示動態調用函數。
• 促進AI模型與非語義內核應用程序之間的互操作性。
• 利用標準化協議進行工具集成，簡化開發過程。

本倉庫提供了一個實際示例，展示瞭如何結合這些技術，並附帶示例代碼，幫助您快速上手。

📦 安裝指南

先決條件

在開始編寫代碼之前，請確保您具備以下條件：

• .NET SDK（推薦版本8.0或更高）。
• 有效的OpenAI API密鑰（或其他與語義內核兼容的LLM提供程序）。
• ModelContextProtocol NuGet包。
• 對C#和語義內核概念有基本的瞭解。
• （可選）一個用於測試的MCP服務器，例如示例"Everything" MCP服務器，用於演示目的。

分步指南

本節將指導您完成將MCP工具與語義內核集成的過程，就像本倉庫中實現的那樣。

第一步：設置項目

1. 克隆此倉庫：

git clone https://github.com/LiteObject/mcp-with-semantic-kernel.git
cd mcp-with-semantic-kernel

2. 恢復依賴項：

dotnet restore

3. 配置您的OpenAI API密鑰（或其他LLM憑據），使用環境變量或用戶機密：

dotnet user-secrets set "OpenAI:ApiKey" "your-api-key"
dotnet user-secrets set "OpenAI:ChatModelId" "gpt-4o"

第二步：連接到MCP服務器

項目中包含使用ModelContextProtocol包連接到MCP服務器的代碼。MCP客戶端從服務器獲取可用工具，然後這些工具可以被語義內核使用。

示例代碼（請參見mcp-with-semantic-kernel/src/Program.cs）：

using ModelContextProtocol;

var mcpConfig = new McpServerConfig
{
    Id = "everything",
    Name = "Everything",
    TransportType = TransportTypes.Sse,
    Location = "http://localhost:8931"
};

var mcpClient = await McpClientFactory.CreateAsync(mcpConfig);
var tools = await mcpClient.ListToolsAsync();

此代碼片段連接到一個MCP服務器（例如，“Everything”演示服務器）並獲取其可用工具。