🚀 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 框架和托管库提供了支持