✨ Power BI Modeling MCP 服务器

Power BI Modeling MCP 服务器实现了 MCP 规范，旨在为 AI Agent 与 Power BI 语义模型之间建立无缝连接。本项目目前处于公开预览阶段，在正式发布（General Availability）之前，实现细节可能会有重大调整。

Power BI Modeling MCP 服务器通过一个本地 MCP 服务器，将 Power BI 语义建模能力赋予您的 AI Agent。这使得开发者和 AI 应用能够以全新的方式与 Power BI 模型进行交互，无论是使用自然语言执行建模变更，还是进行自主的 AI Agent 开发工作流。

💡 您可以做什么？

• 🔄 使用自然语言构建和修改语义模型 - 只需告诉您的 AI 助手您的需求，它就能利用此 MCP 服务器在 Power BI Desktop 和 Fabric 语义模型中创建、更新和管理表、列、度量值、关系等。

• ⚡ 大规模批量操作 - AI 应用可以同时对数百个对象执行批量建模操作（如批量重命名、批量重构、模型翻译或模型安全规则配置），并支持事务和错误处理，将数小时的重复性工作缩短至秒级。

• ✅ 应用建模最佳实践 - 轻松评估并针对您的模型实施建模最佳实践。

• 🤖 Agent 开发工作流 - 支持使用 TMDL 和 Power BI 项目文件，使 AI Agent 能够跨语义模型代码库自主规划、创建并执行复杂的建模任务。

• 🔍 查询和验证 DAX - AI 助手可以针对您的模型执行并验证 DAX 查询，帮助您测试度量值、排查计算问题并探索数据。

📹 观看视频查看端到端演示。

[!WARNING]

• 将 AI Agent 连接到语义模型时请务必谨慎。底层 LLM 可能会产生意外或不准确的结果，从而导致非预期的更改。在执行任何操作之前，请务必备份您的模型。
• LLM 可能会在日志或响应中无意间泄露语义模型中的敏感信息（包括数据或元数据）。在共享聊天会话时请务必谨慎。 请参阅 数据隐私与 LLM 提供商。
• Power BI Modeling MCP 服务器仅能执行建模操作。它无法修改其他类型的 Power BI 元数据，例如报表页面或图表布局等语义模型元素。
• 您选择的 AI 模型直接影响响应的质量和相关性。为了获得最佳效果，请选择深度推理模型，例如 GPT-5 或 Claude Sonnet 4.5。您可以在 GitHub Copilot AI 模型比较 中找到有关可用模型的更多详细信息。

📦 安装

安装此 MCP 服务器最简单的方法是结合使用 Visual Studio Code 扩展 和 GitHub Copilot。当然，您也可以将其手动安装到任何其他 MCP 客户端中。

Visual Studio Code（推荐）

1. 安装 Visual Studio Code。

2. 安装 GitHub Copilot 和 GitHub Copilot Chat 扩展。

3. 安装 Power BI Modeling MCP Visual Studio Code 扩展。

   

4. 打开 GitHub Copilot chat 并确认 powerbi-modeling-mcp 已启用并被选中。

   

手动安装

此 MCP 服务器也可以在其他 IDE、CLI 和 MCP 客户端中进行配置：

1. 使用以下 URL 下载您所需版本的 VSIX 包：
   • 模板：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/analysis-services/vsextensions/powerbi-modeling-mcp/[version]/vspackage?targetPlatform=[platform]
   • 示例（版本 0.1.9，平台 win32-x64）：https://marketplace.visualstudio.com/_apis/public/gallery/publishers/analysis-services/vsextensions/powerbi-modeling-mcp/0.1.9/vspackage?targetPlatform=win32-x64
2. 将下载的 .visx 文件重命名为 .zip。
3. 将内容解压到您选择的文件夹中，例如：C:\MCPServers\PowerBIModelingMCP
4. 运行 \extension\server\powerbi-modeling-mcp.exe。
5. 从控制台复制 MCP JSON 注册信息，并将其注册到您首选的 MCP 客户端工具中。

以下是适用于大多数 MCP 客户端的配置示例：

{
  "mcpServers": {
    "powerbi-modeling": {
      "command": "C:\\MCPServers\\PowerBIModelingMCP\\extension\\server\\powerbi-modeling-mcp.exe",
      "args": []
    }
  }
}