项目简介

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) 与客户端建立连接。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/srikanth-paladugula/mcp-dyamics365-server.git
    cd mcp-dyamics365-server
  2. 安装依赖:

    npm install
  3. 配置环境变量: 在项目根目录下创建 '.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 的访问权限。

  4. 编译 TypeScript 代码:

    npm run build
  5. 运行 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 客户端才能与此服务器进行交互。

信息

分类

商业系统