Skip to main content
Glama
codeurali

MCP Dataverse

by codeurali

MCP Dataverse

最完整的 Microsoft Dataverse MCP 服务器。

79 个工具 · 4 个资源 · 10 个引导式工作流 · 三种认证模式

npm npm downloads CI Node 20+ TypeScript License: MIT

→ 完整文档


为什么选择 MCP Dataverse?

AI 代理经常会产生模式幻觉、猜错列名并构建出错误的 OData 查询。该服务器通过 Model Context Protocol 为它们提供对 Dataverse 环境(模式、记录、元数据、解决方案)的实时访问。

  • 三种认证模式 — 设备代码(本地)、客户端凭据(CI/CD)、托管标识(Azure 托管)

  • 适用于任何 MCP 客户端 — VS Code、Claude、Cursor、Windsurf、Gemini、Codex CLI

  • 原子化工具 — 每个工具各司其职;AI 会自动选择最合适的工具

  • 结构化输出 — 每个响应都会返回 {summary, data, suggestions}

  • 护栏机制 — 破坏性操作需要明确确认

  • 加密令牌 — AES-256-GCM 缓存凭据,绝不记录日志


Related MCP server: xrm-mcp

安装

npx mcp-dataverse install

交互式向导可在 2 分钟内配置您的环境、在 VS Code 中注册服务器并验证您的 Microsoft 账户。

需要 Node.js 20+。对于其他客户端(Claude、Cursor、Windsurf 等),请参阅 多客户端设置。


认证

三种模式 — 根据服务器运行位置进行选择:

模式

使用场景

设备代码 (默认)

本地开发 — 交互式 Microsoft 登录,令牌缓存于磁盘

客户端凭据

无人值守:CI/CD、Docker、Azure 服务 — authMethod: "client-credentials" + 应用注册

托管标识

Azure 托管 (App Service, Container Apps) — 无需密钥,authMethod: "managed-identity"

设备代码快速入门: 首次调用工具时触发认证。

  1. 打开 View → Output → MCP — 登录代码会显示在此处

  2. 前往 https://microsoft.com/devicelogin,输入代码,并使用您的工作账户登录

  3. 令牌将被加密缓存 — 后续所有启动均无需再次登录

有关客户端凭据和托管标识的设置,请参阅 认证文档。


功能

类别

数量

描述

元数据

9

表、模式、关系、选项集、实体键

查询

3

OData、FetchXML、分页检索

CRUD

6

获取、创建、更新、删除、更新插入、分配

关系

4

关联、批量关联、取消关联、查询关联

操作与函数

6

绑定/未绑定的 Dataverse 操作和函数

批处理

1

原子化执行多达 1000 个操作

解决方案

2

发布自定义项、创建站点地图

搜索

1

全文相关性搜索

用户与团队

4

用户、角色、团队、角色分配

RBAC

7

角色权限:列出、分配、移除、添加、替换、获取、团队

文件

2

上传/下载文件和图像列

审计与追踪

3

审计日志、插件追踪日志、工作流追踪日志

注释

2

备注和文件附件

自定义

4

自定义操作、插件、环境变量、连接引用

属性

4

创建、更新、删除列;查找列类型

模式 (写入)

2

创建自定义表和关系

记录访问

4

检查、授予、撤销记录共享;合并记录

辅助

2

工具路由、工具标签

+ 更多

…

增量同步、模拟用户、视图、业务部门、重复检测

→ 完整功能参考


HTTP 传输

作为 HTTP 服务器运行以供多客户端使用:

MCP_TRANSPORT=http MCP_HTTP_PORT=3000 MCP_HTTP_SECRET=mysecret node dist/server.js

使用 VS Code / Copilot 连接:

{
  "servers": {
    "dataverse": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer mysecret"
      }
    }
  }
}

故障排除

症状

修复

无登录提示

打开 View → Output → MCP — 设备代码显示在此处

No MSAL accounts found

运行 npx mcp-dataverse-auth 然后重启服务器

Authentication timed out

重启 MCP 服务器 — 会自动生成新的代码

服务器未在 Agent 模式下显示

运行 npx mcp-dataverse install 或 npx mcp-dataverse doctor

HTTP 错误

运行 npx mcp-dataverse doctor 以诊断配置和连接性


性能提示

MCP Dataverse 设计全面,但大多数 AI 模型在上下文中使用较少工具时表现最佳。在客户端的工具选择器(例如 VS Code Chat 面板)中取消选择您不需要的工具,以保持代理的专注和响应速度。


路线图

版本

功能

状态

v0.4

HTTP 传输 + 属性管理 + 模式一致性

✅ 已发布

v0.5

企业级认证 (客户端凭据, 托管标识, Entra JWT)

✅ 已发布

v0.6

MCP Prompts (5 个模板) + MCP Resources (4 个)

✅ 已发布

v0.7

模式写入 (创建表/关系) + 记录访问 (共享, 合并)

✅ 已发布 (v0.7.5)

→ 完整路线图


许可证

MIT © Ali Taggaz

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    B
    maintenance
    A minimal MCP server that gives AI coding agents clean read and write access to Microsoft Dataverse environments via the Dataverse Web API v9.2. It works as a drop-in alternative to Microsoft's own MCP server, without requiring Copilot Credits or managed environments.
    8
    20
    -
  • A
    license
    A
    quality
    A
    maintenance
    MCP server for Microsoft Dataverse API with safe-by-default configuration. Works with any Dataverse / Dynamics 365 environment.
    23
    406 npm
    8
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server for OData v4 endpoints, especially Microsoft Dataverse/Dynamics 365, enabling authentication, schema discovery, querying, CRUD, and more via natural language.
    -