MCP-Demo：模型上下文协议与 OpenAI 集成

这是一个针对 .NET 应用程序的模型上下文协议 (MCP) 的全面演示，展示了如何创建 MCP 客户端和服务器，以及如何将它们与 OpenAI 的 LLM 功能集成。

什么是 MCP？

模型上下文协议 (MCP) 是一个开放协议，它标准化了应用程序如何向大型语言模型 (LLM) 提供上下文。它实现了 LLM 与各种数据源和工具之间的安全集成，从而提供了一种标准化的方式来扩展 LLM 的功能。

此演示展示了：

• 一个公开自定义工具的 MCP 服务器
• 一个可以连接到服务器的 MCP 客户端
• 与 OpenAI 的集成，以便在对话中使用这些工具

解决方案结构

MCP-Demo/
├── MCP.Server/        # 带有自定义工具的 MCP 服务器
├── MCP.Client/        # 用于测试工具的简单客户端
├── MCP.LlmIntegration/ # OpenAI 与 MCP 工具的集成
└── README.md          # 此文档

功能

MCP 服务器

公开了几个基于函数的工具：

• Echo: 返回带有输入消息的问候语
• Add: 将两个数值相加
• GetDateTime: 返回当前日期和时间

OpenAI 集成

• 使用您的 API 密钥连接到 OpenAI API
• 维护对话上下文
• 从 AI 响应中提取工具调用
• 通过 MCP 服务器执行工具
• 将工具结果返回给用户

快速入门

前提条件

• .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 工具进行交互

使用示例

以下是一些与演示交互的示例：

基本计算

你：42 加 17 等于多少？

AI：我将使用 Add 工具为您计算。
[TOOL_CALL:Add(a=42, b=17)]

正在执行工具：Add
参数：
  a: 42
  b: 17

工具结果：
  59

日期和时间检查

你：现在几点？

AI：让我为您查看当前时间。
[TOOL_CALL:GetDateTime()]

正在执行工具：GetDateTime
参数：

工具结果：
  2025年4月4日星期五 下午3:45:21

Echo 测试

你：你能回显短语“MCP 正在工作！”吗？

AI：我将为您回显该短语。
[TOOL_CALL:Echo(message="MCP is working!")]

正在执行工具：Echo
参数：
  message: MCP is working!

工具结果：
  hello MCP is working!

架构

集成通过以下组件工作：

1. MCP 服务器: 使用 ModelContextProtocol.Server 命名空间托管工具实现
2. MCP 客户端: 使用 stdio 连接到服务器并提供工具执行功能
3. OpenAI 客户端: 使用 OpenAI Chat API 处理对话
4. 工具提取: 使用正则表达式从 AI 响应中解析工具调用
5. 工具执行: 将工具调用路由到 MCP 服务器并返回结果

扩展项目

添加新工具

要向 MCP 服务器添加新工具，请向 DemoTools 类添加一个新方法：

[McpServerTool, Description("计算一个数的平方")]
public static double Square(double number) => number * number;

该工具将被自动发现并提供给 LLM 使用。

自定义 OpenAI 集成

您可以通过以下方式修改 OpenAI 集成：

• 更改模型（例如，更改为“gpt-3.5-turbo”以降低成本）
• 添加额外的系统指令
• 实施更复杂的对话管理

故障排除

常见问题：

• 服务器未找到: 确保 LLM 集成中的服务器路径正确
• API 密钥问题: 验证您的 OpenAI API 密钥是否在用户机密中正确设置
• 工具执行错误: 检查工具参数是否与 AI 尝试发送的内容匹配

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

致谢

• 模型上下文协议 用于创建协议规范
• OpenAI 用于他们的 .NET 客户端库
• Microsoft 用于 .NET 框架和托管库