d365-agent-mcpserver-dotnet\n\nC#/.NET implementation of the MCP Server for the Dynamics 365 AI Agent.

Dynamics 365 AI Agent - D365 MCP 服务（.NET）（d365-agent-mcpserver-dotnet）

此存储库包含 Dynamics 365 Model Context Protocol（MCP）服务的 .NET Core 实现源代码。此服务是 D365 AI Agent 系统的关键组件，负责将 Dynamics 365 业务逻辑和数据操作公开为标准化的 MCP 工具。

概述

d365-agent-mcpserver-dotnet 是 Dynamics 365 的专用网关。它接收客户端发来的 MCP 工具执行请求（主要由 d365-agent-orchestrator 通过 d365-agent-mcpclient-ts 库发送），并将这些请求转换为针对 D365 OData API 的操作。

主要功能与职责

• MCP 工具实现： 定义并实现一组 MCP 工具，用于封装特定的 Dynamics 365 操作（例如，getCustomerDetails、createSalesOrder、simulateInvoicePostToD365、getPurchaseOrderStatus）。
• D365 OData 交互： 使用生成的、类型安全的 C# OData 客户端（来自 d365-agent-odataclient-dotnet 存储库）与 Dynamics 365 OData 终结点进行所有通信。
• D365 身份验证： 管理与 Dynamics 365 的安全身份验证（通常采用客户端凭据流），并从 Azure Key Vault 获取必要的凭据。
• 多实例支持： 可根据 MCP 工具调用中传递的参数，处理针对多个 Dynamics 365 实例或法人实体的请求。
• 标准化接口： 通过 Model Context Protocol 公开 D365 功能，使任何符合 MCP 规范的客户端都能发现并使用其工具。
• 错误处理： 为 D365 操作实现稳健的错误处理，并通过标准 MCP 错误响应返回错误。
• 容器化： 打包为 Docker 容器，以便部署到 Azure Container Apps（ACA）或 Azure Kubernetes Service（AKS）等 Azure 服务。

技术栈

• .NET Core / ASP.NET Core（用于托管 MCP 服务终结点）
• C#
• D365 Agent C# MCP SDK（来自 submodules/csharp-sdk 或相应的 NuGet 包）
• 生成的 D365 OData 客户端（来自 d365-agent-odataclient-dotnet）
• MSAL.NET（用于 Azure AD 身份验证）

交互流程

1. d365-agent-orchestrator（具体而言，是 LangGraph Agent 或使用 d365-agent-mcpclient-ts 的 CopilotKit 操作）向此服务发送 MCP CallTool 请求。
2. d365-agent-mcpserver-dotnet 接收请求。
3. 它识别请求调用的 MCP 工具并验证参数。
4. 工具实现逻辑使用生成的 D365 OData 客户端（d365-agent-odataclient-dotnet）针对 Dynamics 365 OData API 执行所需操作（例如，查询数据、创建或更新实体）。
5. D365 返回的结果或任何错误都会被封装到 McpResponse 中。
6. McpResponse 会发送回 d365-agent-orchestrator。

入门

（待补充详情——通常包括克隆存储库、设置 .NET SDK、配置 D365 环境和 Azure Key Vault，以及运行服务。） 详细开发计划请参阅此存储库中的 implementation.md。

贡献

（如适用，请参阅贡献指南相关详情）