Power BI Desktop MCP Server

版本 2.0.9 - Power BI Desktop 的 Model Context Protocol 服务器

兼容工具：Claude Desktop • Claude Code • VS Code (GitHub Copilot) • 其他兼容 MCP 的 AI 工具

开发者：Maxim Anatsko | maxanatsko.com

注意：这是一个独立的社区开发工具，与微软公司没有任何关联、认可或联系。

<img src="https://gips3.baidu.com/it/u=2811292181,1350118012&fm=3081&app=3081&f=PNG?w=545&h=153" width="175" alt="买我一杯咖啡">

可用版本

此 MCP 服务器有两个版本：

• 完整版 (powerbi-desktop-mcp) - 提供全部 26 个工具，包括创建、更新和删除模型对象的能力。
• 只读版 (powerbi-desktop-mcp-readonly) - 安全浏览，仅提供 9 个读取和分析工具，不能修改你的 Power BI 模型。

如果你希望在不改变模型的情况下进行探索和分析，请选择只读版。

目录

• 这是什么？
• 隐私及数据
• 关键特性
• 前提条件
• 安装
  • 选项 1：Claude Desktop 使用 .mcpb 包（推荐）
  • 选项 2：Claude Desktop 使用 .exe（手动配置）
  • 选项 3：Claude Code 使用 .exe
  • 选项 4：VS Code 带有原生 MCP 支持
• 开始使用
• 可用工具
• 示例用例
• 故障排除
• 安全及隐私
• 限制
• 支持
• 作者及许可

这是什么？

Power BI Desktop MCP 服务器是一个工具，允许像 Claude、GitHub Copilot 和其他兼容 MCP 的 AI 工具与你的 Power BI 模型进行程序化交互。它使 AI 能够读取你的模型结构，运行 DAX 查询，创建和修改度量值，管理关系，并执行高级分析——所有这些都可以通过自然对话完成。

你可以把它想象成给 AI “眼睛和手”，让它能够操作你的 Power BI 模型，从而实现任务自动化、数据分析和利用 AI 辅助构建解决方案。

隐私及数据

MCP 服务器：零数据收集

重要提示：此 MCP 服务器不会收集、跟踪或存储任何数据。

Power BI Desktop MCP 服务器是一个本地桥接应用程序，其特点如下：

• 完全在你的机器上运行
• 不向任何外部服务器发送遥测数据
• 不跟踪分析或使用数据
• 不记录你的个人信息或 Power BI 模型数据
• 不上传你的数据到任何地方

数据流： MCP 服务器作为你本地机器上的两个组件之间的简单传递：

1. 你的 Power BI Desktop → MCP 服务器（读取模型结构，执行查询）
2. MCP 服务器 → 你的 AI 助手（发送响应）

就是这样。没有任何数据被发送到 MCP 服务器开发者或任何第三方服务。

AI 助手隐私：非我们的责任

关键澄清：

这个 MCP 服务器是你使用的 AI 助手（如 Claude、GitHub Copilot 等）之外的一个独立软件。AI 助手有自己的隐私政策和数据实践，完全独立于这个 MCP 服务器。

当你使用这个 MCP 服务器与一个 AI 助手时：

• AI 助手（如 Claude Desktop、Claude Code、VS Code 带有 GitHub Copilot 等）可能会根据自己的隐私政策收集和存储对话数据
• 查看你选择的 AI 助手的隐私政策：
  • Claude Desktop/Claude Code：Anthropic 的隐私政策
  • VS Code 带有 GitHub Copilot：Microsoft/GitHub 隐私政策
• MCP 服务器开发者不对 AI 助手如何处理你的数据负责
• 注意你从 Power BI 模型中请求 AI 分析的数据

你的责任：

• 了解 AI 助手是具有自己数据实践的第三方服务
• 查看你选择使用的 AI 助手的隐私政策
• 小心地暴露敏感或机密数据给 AI 助手
• MCP 服务器本身不会在请求之间保留任何数据——但你的 AI 助手可能保留

关键特性

🎯 用于 Power BI 模型操作的 26 个强大工具

模型管理

• 自动发现并连接到正在运行的 Power BI Desktop 实例
• 列出可用模型并选择要工作的模型
• 获取当前连接状态
• 管理模型属性（描述、文化、注释）

数据探索与分析

• 列出并描述表、列、度量值和层次结构
• 预览表数据，可配置行数限制
• 导出完整的模型架构为 JSON
• 执行 DAX 查询，结果最多 1000 行
• 获取列统计信息（最小值、最大值、空值计数、唯一值）
• 存储引擎和公式引擎指标的查询性能分析

表操作

• 创建具有多种分区类型的表
• 更新表属性和结构
• 从模型中删除表
• 标记表为日期表以进行时间智能

度量值管理

• 使用动态格式字符串表达式创建新的 DAX 度量值
• 更新现有度量值，包括名称和表达式
• 删除度量值
• 使用静态或动态表达式格式化字符串
• 显示文件夹组织

关系操作

• 列出所有关系及其基数和交叉筛选方向
• 创建具有完全控制的新关系
• 更新关系属性（活动状态、方向、基数）
• 删除关系

分区管理（适用于所有分区类型）

• 创建和管理 M（Power Query）、查询（SQL）、计算（DAX）和实体（数据流）分区
• 支持导入、直接查询和双重存储模式
• 在细粒度级别刷新分区
• 查看分区表达式和配置

高级模型功能

• 用户定义函数（UDF）：创建、更新和删除带有参数的自定义 DAX 函数
• 计算组：创建带有动态计算项的计算组
• 层次结构：管理具有多个层级和排序的层次结构
• 关键绩效指标（KPI）：创建带有目标、状态和趋势表达式的 KPI
• 角色及安全性：管理具有行级和对象级安全性的安全角色（RLS/OLS）
• 视角：创建视角以过滤不同用户组的模型对象
• 日历：配置带有多个时间单位的时间智能日历

多语言支持

• 文化：添加语言/地区到你的模型
• 翻译：翻译表/列/度量值名称和描述
• 支持 40 多种文化代码（en-US、fr-FR、de-DE、es-ES、zh-CN 等）

数据源管理

• 列出数据源及其配置
• 按类型和存储模式查看分区信息
• 分析 M 分区表达式
• 获取数据源详细信息和连接

搜索与发现

• 按名称模式搜索对象（表、列、度量值、计算列）
• 跨 DAX 和 M 表达式的全文搜索
• 支持大小写敏感或不敏感的搜索模式
• 查找具有表达式的计算列

存储与性能优化

• VertiPaq 统计信息，包括字典大小、数据大小、编码
• 列基数分析
• 压缩比评估
• 存储模式分析（导入 vs 直接查询）

刷新操作

• 刷新单个表分区
• 刷新整个表
• 整个模型刷新
• UDF 和计算的元数据刷新

前提条件

在安装之前，请确保你拥有以下内容：

1. Windows 10/11（仅限 Windows 的应用）
2. 已安装 Power BI Desktop（下载 MSI 或从 Microsoft Store 下载）
3. 以下任意一个 AI 助手：
   • Claude Desktop（推荐用于 .mcpb 包安装）
   • Claude Code（基于 CLI 的编码环境）
   • VS Code 带有 GitHub Copilot（需要 VS Code 1.102+）

注意：.exe 和 .mcpb 包是自包含的，包含了所有必要的运行时组件。不需要单独安装 .NET。

安装

你可以通过三种方式安装 Power BI MCP 服务器。每种方法都适用于完整版和只读版——只需使用对应版本的包或可执行文件即可。

选项 1：Claude Desktop 使用 .mcpb 包（推荐）

.mcpb 包是最简单的安装方式——它是专门为 Claude Desktop 设计的自包含扩展。

1. 下载包：

   • 完整版：powerbi-desktop-mcp-2.0.9.mcpb（所有工具，包括创建/更新/删除）
   • 只读版：powerbi-desktop-mcp-readonly-2.0.9.mcpb（仅查看和分析）

2. 安装扩展：

   • 简单方法：双击 .mcpb 文件。Claude Desktop 将打开并显示安装对话框。
   • 替代方法：
     • 打开 Claude Desktop
     • 前往设置（齿轮图标）→ 扩展
     • 点击“高级设置”→“扩展开发者”部分
     • 点击“安装扩展...”
     • 选择下载的 .mcpb 文件（完整版或只读版）
     • 在对话框中点击“安装”

3. 重启 Claude Desktop：完全退出并重新启动应用程序（不仅仅是关闭窗口）

服务器将自动配置并准备好使用。当服务器激活时，你会在对话框输入框右下角看到 MCP 指示器。

选项 2：Claude Desktop 使用 .exe（手动配置）

如果你更喜欢手动配置或需要更多控制：

1. 下载可执行文件：

   • 完整版：powerbi-desktop-mcp-2.0.9.exe（所有工具）
   • 只读版：powerbi-desktop-mcp-readonly-2.0.9.exe（仅查看和分析）

2. 放置在永久位置：例如，C:\Program Files\PowerBI-MCP\powerbi-desktop-mcp-2.0.9.exe（或只读版）

3. 编辑配置文件：

   • 打开 Claude Desktop
   • 点击设置图标（左下角的齿轮图标）
   • 导航到开发者标签
   • 点击“编辑配置”按钮
   • 这将在默认文本编辑器中打开 claude_desktop_config.json

   文件位置：%APPDATA%\Claude\claude_desktop_config.json（Windows）

4. 添加此配置：

{
  "mcpServers": {
    "powerbi-desktop": {
      "command": "C:\\Program Files\\PowerBI-MCP\\powerbi-desktop-mcp-2.0.9.exe",
      "args": []
    }
  }
}

注意：在 Windows 路径中使用双反斜杠（\\）。如果你已经配置了其他 MCP 服务器，请将 powerbi-desktop 条目添加到现有的 mcpServers 对象中。

5. 保存文件并完全退出并重新启动 Claude Desktop

重新启动后，你会在对话框输入框右下角看到 MCP 指示器，表明服务器已连接。

选项 3：Claude Code 使用 .exe

对于 Claude Code（编码环境）：

1. 下载可执行文件：

   • 完整版：powerbi-desktop-mcp-2.0.9.exe（所有工具）
   • 只读版：powerbi-desktop-mcp-readonly-2.0.9.exe（仅查看和分析）

2. 放置在永久位置：例如，C:\Program Files\PowerBI-MCP\powerbi-desktop-mcp-2.0.9.exe（或只读版）

3. 使用命令行添加 MCP 服务器：

   打开 Claude Code 并使用内置终端或命令面板：

# 完整版
claude mcp add --transport stdio powerbi-desktop -- "C:\Program Files\PowerBI-MCP\powerbi-desktop-mcp-2.0.9.exe"

# 或只读版
claude mcp add --transport stdio powerbi-desktop-readonly -- "C:\Program Files\PowerBI-MCP\powerbi-desktop-mcp-readonly-2.0.9.exe"

此命令将：

• 添加一个新的名为“powerbi-desktop”的 MCP 服务器
• 配置其使用 stdio 传输（标准输入/输出）
• 设置可执行文件路径

4. 选择安装范围 当提示时：

   • 本地：仅限当前项目
   • 项目：通过 .mcp.json 文件共享（提交到版本控制）
   • 用户：跨所有项目可用（推荐）

5. 重启 Claude Code 或重新加载窗口

服务器将在所有对话中可用。你可以在 UI 中检查 MCP 服务器指示器来验证其是否运行。

选项 4：VS Code 带有原生 MCP 支持（Windows）

VS Code 从版本 1.102 开始具有原生 MCP 支持。需要 GitHub Copilot。

注意：此服务器仅在 Windows 上工作，因为它需要 Power BI Desktop。

1. 下载可执行文件：

   • 完整版：powerbi-desktop-mcp-2.0.9.exe
   • 只读版：powerbi-desktop-mcp-readonly-2.0.9.exe

2. 放置在永久位置：例如，C:\Program Files\PowerBI-MCP\powerbi-desktop-mcp-2.0.9.exe

3. 在工作区创建 .vscode/mcp.json：

   {
     "servers": {
       "powerbi-desktop": {
         "type": "stdio",
         "command": "C:\\Program Files\\PowerBI-MCP\\powerbi-desktop-mcp-2.0.9.exe",
         "args": []
       }
     }
   }
   

   提示：使用命令面板 → “MCP: 添加服务器” → 选择“全局”以应用于所有工作区

4. 重启 VS Code

5. 启用代理模式：在 Copilot Chat 中，点击“工具”按钮以启用 MCP 工具

详见 VS Code MCP 文档。

开始使用

1. 启动 Power BI Desktop

打开 Power BI Desktop 并加载你想要工作的 .pbix 文件。MCP 服务器会自动发现正在运行的 Power BI 实例。

2. 启动你的 AI 助手

启动你选择的 AI 助手：

• Claude Desktop 或 Claude Code：Power BI MCP 服务器会在后台自动启动
• VS Code 带有 GitHub Copilot：打开配置的工作区中的 VS Code，MCP 服务器将在 Copilot Chat 中可用（通过点击“工具”按钮启用代理模式）

3. 列出可用模型

如果你打开了多个 Power BI 文件，询问你的 AI 助手：

"列出我的可用 Power BI 模型"

AI 将调用 manage_model_connection，操作为 list，以显示所有正在运行的实例。

4. 选择模型

告诉 AI 连接到哪个模型：

"连接到模型 1" 或 "连接到 [模型名称]"

5. 开始工作！

现在你可以自然地与你的 Power BI 模型互动：

探索你的模型：

"展示我模型中的所有表"
"销售表有哪些列？"
"财务表有哪些度量值？"

分析数据：

"展示客户表的预览"
"类别列有哪些唯一值？"
"运行此 DAX 查询：EVALUATE TOPN(1_0, 销售, [销售额], DESC)"

创建度量值：

"在度量值表中创建一个名为总收入的度量值，表达式为 SUM(销售[金额])"
"添加一个年同比增长率度量值，带有百分比格式"

管理关系：

"列出我模型中的所有关系"
"从销售[产品ID]到产品[ID]创建一个关系"
"使销售和日期之间的关系双向"

搜索和发现：

"查找所有名称中包含'客户'的对象"
"搜索所有使用 CALCULATE 函数的度量值"

性能分析：

"展示销售表的 VertiPaq 统计信息"
"哪些列具有最高的基数？"
"分析此 DAX 查询的性能"

可用工具

模型管理（1 个统一工具）

• manage_model_connection - 发现