.NET OpenAI MCP Agent

---

name: .NET OpenAI MCP Agent description: 这是一个使用 Azure OpenAI 编写的 .NET MCP Agent 应用，并搭配一个使用 TypeScript 编写的远程 MCP 服务。 languages:

• csharp
• bicep
• azdeveloper products:
• azure-openai
• azure-container-apps
• azure page_type: sample urlFragment: openai-mcp-agent-dotnet

---

.NET OpenAI MCP Agent

这是一个使用 Azure OpenAI 编写的 .NET MCP Agent 应用，并搭配一个使用 TypeScript 编写的远程 MCP 服务。

功能

此应用提供以下功能：

• MCP 主机和 MCP 客户端应用使用 .NET Blazor 编写。
• MCP 客户端应用连接到一个使用 TypeScript 编写的待办事项 MCP 服务。
• MCP 客户端和服务应用均运行在 Azure Container Apps (ACA) 上。
• MCP 客户端应用由 ACA 内置的身份验证功能保护。
• MCP 服务应用仅可由 MCP 客户端应用访问。

先决条件

• .NET 9 SDK
• Visual Studio Code + C# Dev Kit
• node.js LTS
• Docker Desktop 或 Podman Desktop
• Azure 订阅

开始使用

现在，你可以使用 GitHub Codespaces 运行此示例应用（打开需要几分钟）！👉 。

获取 Azure AI Foundry 或 GitHub Models

• 要运行此应用，你需要有一个 Azure AI Foundry 实例。
• 如果使用 Azure AI Foundry，请确保已部署 GPT-5-mini 模型。
• 默认情况下，已部署的模型名称为 gpt-5-mini。

获取 AI Agent 应用

1. 为应用创建一个目录。

   # zsh/bash
   mkdir -p openai-mcp-agent-dotnet
   

   # PowerShell
   New-Item -ItemType Directory -Path openai-mcp-agent-dotnet -Force
   

2. 初始化 azd。

   cd openai-mcp-agent-dotnet
   azd init -t openai-mcp-agent-dotnet
   

   NOTE：系统会要求你输入环境名称，该名称将作为 Azure 资源组的名称。例如，环境名称可以是 openai-mcp-agent。

在 Azure 上运行

1. 检查你是否拥有所需权限：

   • 你的 Azure 帐户必须拥有 Microsoft.Authorization/roleAssignments/write 权限，例如在订阅级别拥有基于角色的访问控制管理员、用户访问管理员或所有者角色。
   • 你的 Azure 帐户还必须在订阅级别拥有 Microsoft.Resources/deployments/write 权限。

2. 登录 Azure。

   azd auth login
   

3. 将应用部署到 Azure。系统会自动查找 MCP 服务应用，并同时部署它。

   azd up
   

   注意：

   1. 默认情况下，MCP 客户端应用受 ACA 内置身份验证功能保护。运行 azd up 之前，可以通过设置以下值关闭此功能：

      azd env set USE_LOGIN false
      

   2. 默认情况下，Agent 使用 gpt-5-mini。可以通过设置以下值将其更改为其他模型：

      azd env set GPT_MODEL_NAME <azure-openai-model-name>
      

   3. 默认情况下，Agent 使用 Azure OpenAI 无密钥身份验证方式。可以通过设置以下值，将其更改为使用 Azure OpenAI API 密钥：

      azd env set AOAI_USE_API_KEY true
      

   4. 默认情况下，Agent 处于生产模式。可以通过设置以下值，将其更改为 Both 或 Client 开发模式，以显示更详细的日志：

      azd env set ENABLE_DEVELOPMENT_MODE Both
      

   5. 默认情况下，MCP 服务应用处于生产模式。可以通过设置以下值，将其更改为 Both 或 Server 开发模式，以显示更详细的日志：

      azd env set ENABLE_DEVELOPMENT_MODE Both
      

   6. 部署期间：

      • 系统会要求你输入 Azure 订阅以及两个位置：一个用于 Azure AI Foundry，另一个用于其余资源。

4. 在终端中获取已部署的客户端应用 URL。它可能如下所示：

   https://mcptodo-clientapp.{{some-random-string}}.{{location}}.azurecontainerapps.io/
   

5. 打开客户端应用 URL，登录应用并输入如下提示词：

   给我待办事项列表。
   添加“下午 1 点开会”。
   给我待办事项列表。
   将 #1 标记为已完成。
   从待办事项列表中删除 #1。
   

   注意：如果你已将 USE_LOGIN 值设为 false，系统可能不会要求你登录。

6. 清理所有已部署的资源。

   azd down --force --prune
   

资源

• OpenAI SDK - .NET
• OpenAI MCP 示例
• Azure OpenAI - 新一代 API
• 如何在 OpenAI 和 Azure OpenAI 终结点之间切换
• .NET AI 模板
• MCP .NET 示例
• TypeScript MCP 待办应用