项目简介
Dynamics 365 MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在为 LLM 应用提供与 Microsoft Dynamics 365 系统交互的能力。通过标准化的 MCP 协议,该服务器允许 LLM 客户端安全、便捷地访问 Dynamics 365 中的数据,并执行相关操作,例如检索用户信息、查询客户账户、获取商机信息以及创建和更新账户等。
主要功能点
- 用户信息查询: 获取当前 Dynamics 365 用户的详细信息。
- 账户信息管理:
- 查询 Dynamics 365 中的所有账户信息。
- 获取指定账户关联的商机信息。
- 创建新的 Dynamics 365 账户。
- 更新已存在的 Dynamics 365 账户信息。
- 基于 MCP 协议: 采用标准的 MCP 协议与客户端通信,保证互操作性和易用性。
- 工具化集成: 将 Dynamics 365 的各项功能封装为独立的工具,方便 LLM 客户端按需调用。
- 使用 Stdio 传输: 通过标准输入输出流 (Stdio) 与客户端建立连接。
安装步骤
-
克隆仓库:
git clone https://github.com/srikanth-paladugula/mcp-dyamics365-server.git cd mcp-dyamics365-server -
安装依赖:
npm install -
配置环境变量: 在项目根目录下创建 '.env' 文件,并填入以下 Dynamics 365 和 Azure AD 相关的配置信息。请替换为您的实际值:
CLIENT_ID=your-client-id # Azure AD 应用程序客户端 ID CLIENT_SECRET=your-client-secret # Azure AD 应用程序客户端密钥 TENANT_ID=your-tenant-id # Azure AD 租户 ID D365_URL=https://your-org.crm.dynamics.com # Dynamics 365 实例 URL请务必确保您的 Azure AD 应用程序已配置 Dynamics 365 API 的访问权限。
-
编译 TypeScript 代码:
npm run build -
运行 MCP 服务器:
node build/index.js成功启动后,您将在控制台看到 "Dynamics365 MCP server running on stdio..." 的提示信息。
服务器配置
以下 JSON 配置信息用于 MCP 客户端连接 Dynamics 365 MCP Server。客户端需要配置 'command' 和 'args' 来启动服务器,并指定 'server name' 以标识该服务器。
{ "server name": "Dynamics365", // 服务器名称,与 McpServer 实例创建时定义的 name 属性一致 "command": "node", // 启动服务器的命令,这里使用 Node.js 运行时 "args": ["build/index.js"] // 启动命令的参数,指向编译后的服务器入口文件 }
基本使用方法
此 MCP 服务器设计用于与 LLM 客户端配合使用。客户端通过 MCP 协议向服务器发送 JSON-RPC 请求,调用预先注册的工具来访问和操作 Dynamics 365 数据。
例如,LLM 客户端可以调用 'get-user-info' 工具来获取当前用户信息,或调用 'fetch-accounts' 工具来获取账户列表。具体工具的使用方法和参数请参考仓库 README.md 文件中 “List of Tools 🛠️” 部分的说明。
请注意: 您需要使用兼容 MCP 协议的 LLM 客户端才能与此服务器进行交互。
信息
分类
商业系统