MCP Server Sample

MCP 服务示例

此项目演示了一个用于管理员工休假天数的 .NET Model Context Protocol（MCP）服务和客户端实现。它提供后端服务，用于跟踪、查询和更新员工的休假余额，并通过 MCP 工具提供这些功能。

组件

• SSE 文件夹包含使用 HTTP Streaming / SEE 传输层的 Model Context Protocol（MCP）客户端-服务实现。该解决方案基于 .NET Aspire，包含一个服务（基于 ASP.NET Core）和一个客户端（使用 Blazor 和 Semantic Kernel 构建的 Web 应用）。
• Stdio 文件夹包含使用标准输入/输出传输层的 Model Context Protocol（MCP）客户端-服务实现。服务以控制台应用的形式实现。

文档

此示例通过一系列博客文章进行说明：

• 在 Agent 中使用 Model Context Protocol - 简介
• 在 Agent 中使用 Model Context Protocol - Copilot Studio
• 在 Agent 中使用 Model Context Protocol - 使用 Semantic Kernel 构建专业代码 Agent

开始使用

此代码库包含两个相同示例的版本：一个使用 C# 和 .NET 构建，另一个使用 TypeScript 构建。

要运行 .NET 示例，需要安装以下先决条件：

• .NET SDK 9.0

要运行 TypeScript 示例，需要安装以下先决条件：

• Node.js

无论使用哪种语言，都需要安装以下先决条件：

• Visual Studio Code
• Visual Studio Code 的 Azurite 扩展

运行 stdio 示例

运行 .NET 示例

1. 点击应用栏中的按钮，或打开命令面板（Ctrl+Shift+P）并选择 Azurite: Start Table Service，启动 Azurite Table 服务模拟器。
2. 使用以下配置连接任意客户端应用（Visual Studio Code、AI Toolkit 或自定义应用）：

• 命令：dotnet
• 参数：run --project src/csharp/Stdio/MCP.Stdio.Server/MCP.Stdio.Server.csproj

运行 TypeScript 示例

1. 点击应用栏中的按钮，或打开命令面板（Ctrl+Shift+P）并选择 Azurite: Start Table Service，启动 Azurite Table 服务模拟器。
2. 使用以下配置连接任意客户端应用（Visual Studio Code、AI Toolkit 或自定义应用）：

• 命令：node
• 参数：/src/ts/stdio/server/dist/app.js

使用前，请运行以下命令编译 TypeScript 代码：

cd src/ts/stdio/server
npm run build

运行 SSE 示例

要运行 SSE 示例，请按照以下步骤操作：

• 将代码库克隆到本地计算机。

• 打开 SSE 文件夹中 MCP.SSE.AppHost 项目内的 appsettings.json 文件，并按照以下格式更新 openAiConnectionName 属性，填入 Azure OpenAI 连接字符串：

  "openAiConnectionName": "Endpoint=https://<your-endpoint>.openai.azure.com/;Key=<your-key>"
  

• 点击应用程序栏中的按钮，或打开命令面板（Ctrl+Shift+P）并选择 Azurite: Start Table Service，启动 Azurite Table 服务模拟器。

• 使用以下命令运行 MCP.SSE.AppHost 项目：

  dotnet run --project MCP.SSE.AppHost/MCP.SSE.AppHost.csproj
  

• 项目启动后，浏览器会自动打开一个新的窗口，显示 Aspire 仪表板。

• 打开一个新的浏览器标签页，并访问以下 URL：

  http://localhost:5291/
  

• 现在，你可以使用 Blazor 应用程序向大模型发送提示词。你可以使用以下任一提示词来触发 MCP 工具的使用：

  "Give me a list of the employees and their vacation days left"
  "Charge 5 vacation days to Alice Johnson""
  

运行 Teams AI 库示例

Teams AI 库示例已注册为 Aspire 解决方案的一部分。不过，在使用之前，你必须按照以下步骤操作：

• 打开 SSE 文件夹中的 ttk2-agent 项目
• 将 .env.example 文件重命名为 .env
• 打开该文件，并更新变量，填入 Azure OpenAI 服务的正确值：
  • AZURE_OPENAI_API_KEY：Azure OpenAI 服务的密钥
  • AZURE_OPENAI_ENDPOINT：Azure OpenAI 服务的终结点
  • AZURE_OPENAI_API_VERSION：API 版本（请注意，这与模型版本不同。你可以在 Azure OpenAI 门户中找到此值）
  • AZURE_OPENAI_MODEL_DEPLOYMENT_NAME：Azure OpenAI 中模型部署的名称

Aspire 仪表板启动并运行后，你会看到 **ttk2-agent **项目有两个终结点：

你可以使用端口号较大的终结点，并在其后添加 /devtools 路径，访问 Agent 的测试工具。 例如，在上图中，URL 为：

http://localhost:54251/devtools/