Aspire.MCP.Sample

使用Aspire的MCP服务器和客户端示例。

概述

此示例展示了如何使用Aspire设置和管理MCP（模型上下文协议）服务器和客户端。它演示了如何在结构化的Aspire环境中使用C#建立和管理MCP通信。

快速演示

观看这个5分钟的视频概述，了解项目运行情况。

观看这个5分钟的视频概述，了解如何将解决方案部署到Azure，并从Visual Studio Code中消费已部署的MCP服务器。

特性

• Aspire集成： 使用Aspire进行容器化编排和服务管理。
• MCP服务器： 实现一个MCP服务器来管理客户端通信。
• MCP客户端： 示例Blazor聊天客户端演示如何连接并与MCP服务器通信。
• 模型选择： 聊天客户端可以使用来自Azure AI Foundry、Ollama或GitHub模型的LLM。所选模型必须支持函数调用，以便能够调用MCP服务器的函数。
• 函数调用： 演示如何使用所选模型调用MCP服务器上的函数。
• 工具结果： 在聊天界面中显示函数调用的结果。
• Azure部署： 可以使用azd命令轻松地将项目部署到Azure。

开始使用

先决条件

• .NET SDK 9.0 或更高版本
• Visual Studio 2022 或 Visual Studio Code
• 支持函数调用的LLM或SLM。
  • Azure AI Foundry 在云端运行模型。例如：gpt-4o-mini
  • GitHub Models 在云端运行模型。例如：gpt-4o-mini
  • Ollama 运行本地模型。建议：phi4-mini, llama3.2 或 Qwq

本地运行

1. 克隆仓库：

2. 导航到Aspire项目目录：

   cd .\src\McpSample.AppHost\
   

3. 运行项目：

   dotnet run
   

4. 在Aspire仪表板中导航到Blazor聊天客户端项目。

   

5. 在聊天设置页面中定义要使用的模型。您可以选择使用Azure AI Foundry中的模型（建议gpt-4o-mini）、GitHub模型或本地的Ollama（建议llama3.2）。

   

6. 现在您可以与模型进行聊天。每次调用MCP服务器的一个功能时，工具结果部分将在聊天中显示。

   

架构图

GitHub Codespaces

(正在进行中)

• 将很快添加Codespaces配置。

部署

一旦您在Codespaces或本地打开了项目，就可以将其部署到Azure。

从终端窗口打开此仓库的克隆文件夹，并运行以下命令。

1. 登录Azure：

   azd auth login
   

2. 配置并部署所有资源：

   azd up
   

   它会提示您提供azd环境名称（如"aspiremcp"），从您的Azure帐户中选择订阅，并选择位置。

3. 当azd完成部署后，您将在命令输出中看到在Azure中创建的资源列表和一组URI。

4. 访问blazorchat URI，您应该能看到MCP聊天应用！🎉

注意： 部署文件位于./src/McpSample.AppHost/infra/文件夹中。它们由Aspire AppHost项目生成。

贡献

欢迎贡献！请随意提交问题和拉取请求。

许可证

本项目根据MIT许可证授权。