MCP With Semantic Kernel

🚀 集成模型上下文协议（MCP）工具与语义内核：分步指南

本仓库展示了如何将模型上下文协议（MCP）工具与微软语义内核集成，以实现AI模型与外部数据源或工具之间的无缝交互。通过遵循本指南，您将学会连接MCP服务器、把MCP工具转换为语义内核函数，并借助大型语言模型（LLMs）进行函数调用，所有这些都在一个可重用且可扩展的框架中完成。

🚀 快速开始

本仓库聚焦于将模型上下文协议（MCP）工具与微软语义内核集成，实现AI模型与外部数据源或工具的无缝交互。您可以通过后续的步骤，学会连接MCP服务器、转换MCP工具为语义内核函数，并利用大型语言模型进行函数调用。

✨ 主要特性

什么是模型上下文协议（MCP）？

模型上下文协议（MCP） 是一种开放标准协议，旨在标准化应用程序为AI模型提供上下文的方式。它就像一个通用连接器，能让LLLMs以一致的方式与各种数据源（如API、数据库或服务）进行交互。可以把MCP想象成一座桥梁，增强了AI的互操作性、灵活性和上下文理解能力。

在本项目中，我们利用MCP来暴露语义内核可使用的工具，从而实现AI驱动的工作流程，并与现实世界中的应用程序（如自动化、数据检索或系统集成）相结合。

为什么将语义内核与MCP结合使用？

Microsoft语义内核 是一个强大的SDK，可简化构建AI代理和编排复杂工作流的过程。通过集成MCP工具，您能获得以下优势：

• 使用MCP服务器扩展语义内核的功能。
• 使LLLMs能根据用户提示动态调用函数。
• 促进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”演示服务器）并获取其可用工具。