MCP Dataverse

最完整的 Microsoft Dataverse MCP 服务器。

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

npm npm downloads 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 缓存凭据，绝不记录日志

安装

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"`

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

打开 View → Output → MCP — 登录代码会显示在此处
前往 https://microsoft.com/devicelogin，输入代码，并使用您的工作账户登录
令牌将被加密缓存 — 后续所有启动均无需再次登录

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

功能

类别	数量	描述
元数据	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)

→ 完整路线图

MCP Dataverse

MCP Dataverse

为什么选择 MCP Dataverse？

安装

认证

功能

HTTP 传输

故障排除

性能提示

路线图

许可证

Resources

Latest Blog Posts

MCP directory API