项目简介

Dynamics 365 Finance & Operations MCP服务器是一个基于FastMCP框架构建的生产就绪实现,通过MCP协议向AI助手提供D365 F&O系统的完整访问能力。

主要功能

  • 49个全面工具:覆盖9个功能类别的所有主要D365 F&O操作
  • 12种资源类型:提供全面的元数据暴露和发现能力
  • 2个提示模板:支持高级工作流辅助
  • 多传输支持:stdio、HTTP、Server-Sent Events (SSE)
  • 数据库分析能力:支持安全SQL查询和元数据洞察
  • 会话同步:详细的进度跟踪和多种同步策略
  • 企业级安全:Azure AD集成、Key Vault支持和审计日志

安装步骤

  1. 使用pip安装

    pip install d365fo-client
  2. 配置环境变量

    export D365FO_BASE_URL="https://your-environment.dynamics.com"
    export D365FO_CLIENT_ID="your-client-id"          # 使用默认凭据时可选
    export D365FO_CLIENT_SECRET="your-client-secret"  # 使用默认凭据时可选
    export D365FO_TENANT_ID="your-tenant-id"          # 使用默认凭据时可选

服务器配置

MCP客户端需要配置以下信息来连接服务器:

FastMCP服务器配置

{
  "servers": {
    "d365fo-fastmcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "d365fo-client@latest",
        "d365fo-fastmcp-server"
    ],
    "env": {
      "D365FO_BASE_URL": "https://your-environment.dynamics.com",
      "D365FO_LOG_LEVEL": "INFO"
    }
  }
}

环境变量说明

  • 'D365FO_BASE_URL':D365 F&O环境的基础URL
  • 'D365FO_CLIENT_ID':Azure AD客户端ID(服务主体认证)
  • 'D365FO_CLIENT_SECRET':Azure AD客户端密钥
  • 'D365FO_TENANT_ID':Azure AD租户ID

基本使用方法

  1. 启动服务器
    # 开发模式(stdio传输)
    d365fo-fastmcp-server
    
    # 生产HTTP API
    d365fo-fastmcp-server --transport http --port 8000 --host 0.0.0.0
    
  2. AI助手集成
    • 在VS Code的mcp.json中添加上述配置
    • 在Claude Desktop配置中添加类似配置

服务器支持多种传输协议,可根据使用场景选择:

  • stdio:用于本地AI助手集成
  • HTTP:用于Web API集成
  • SSE:用于实时Web应用

信息

分类

商业系统