d365-agent-mcpserver-ts\n\nTypeScript implementation of the MCP Server for the Dynamics 365 AI Agent.

Dynamics 365 AI Agent - MCP Server (TypeScript) (d365-agent-mcpserver-ts)

此代码库包含 Model Context Protocol (MCP) 服务的 TypeScript/Node.js 实现源码。此服务可用于向符合 MCP 规范的客户端提供各种工具和功能。

概述

d365-agent-mcpserver-ts 用作服务，AI Agent（例如使用 d365-agent-orchestrator 中的 LangGraph 构建的 Agent）可以通过 MCP 客户端（例如 d365-agent-mcpclient-ts）连接到该服务。它可以提供与 Dynamics 365 或其他后端系统相关的工具。

主要功能与职责

• MCP 服务实现： 使用 TypeScript MCP SDK（来自 submodules/typescript-sdk/packages/mcp-server 或相应的 npm 包）实现 Model Context Protocol 的服务端要求。
• 工具定义与提供： 允许开发者定义并提供自定义工具，指定其输入/输出架构和实现逻辑。
• D365 集成（可能/有条件）：
  • 如果用于集成 Dynamics 365，理想情况下应使用由 d365-agent-odataclient-ts 生成的 TypeScript D365 OData 客户端。
  • 当前状态说明： d365-agent-odataclient-ts 存在已知的 D365 连接问题。因此，对于特定于 D365 的工具，当前 D365 AI Agent 架构中的主要推荐 MCP 服务是 d365-agent-mcpserver-dotnet（它使用可正常工作的 .NET OData 客户端）。
• 其他用途： 此 TypeScript MCP 服务可用于：
  • 提供与其他（非 D365）后端系统、数据库或 API 交互的工具。
  • 实现无需访问 D365 OData 的自定义逻辑或计算工具。
  • 如果未来解决了 d365-agent-odataclient-ts 的问题，可用作轻量级 MCP 工具服务。
• 容器化： 设计为可打包成 Docker 容器进行部署。

技术栈

• TypeScript / Node.js
• 用于 HTTP 传输的 Web 框架（例如 Express、Fastify，或内置于 MCP Server SDK 中的框架）。
• D365 Agent TypeScript MCP SDK（来自 submodules/typescript-sdk 或其 npm 包）。
• 如果用于 D365 且问题已解决，可能会使用 d365-agent-odataclient-ts。

交互流程（通用 MCP 服务）

1. MCP 客户端（例如来自 d365-agent-orchestrator 的 d365-agent-mcpclient-ts）连接到此服务。
2. 客户端可以使用 discoverTools 获取可用工具及其架构的列表。
3. 客户端发送针对特定工具的 MCP CallTool 请求，并附带参数。
4. d365-agent-mcpserver-ts 执行该工具的实现逻辑。
5. 结果或错误会封装到 McpResponse 中，并发送回客户端。

开始使用

（待补充详情——通常包括克隆仓库、配置 Node.js/TypeScript、安装依赖、定义工具和运行服务）。 有关详细的开发计划，请参阅此代码库中的 implementation.md。

贡献

（如适用，补充贡献指南详情）。