Horizun PBI MCP

Horizun PBI MCP

只需描述需求，即可构建和修复 Power BI 报表。 用日常语言提出需求；服务会运行 DAX、编辑模型、编写报表页， 然后检查自己的工作。

无许可证、无 API 密钥、无付费方案

它作为本地进程运行在你自己的 Windows 电脑上，因此免费应用就足够了：在免费版的 ChatGPT Desktop 或 Claude Desktop 中安装，然后开始提问。无需 OpenAI 或 Anthropic API 密钥，无需订阅，中间也没有我们的服务；Power BI Desktop 同样免费。只需单击一次即可安装，并自动准备运行环境：无需 Python，也无需编辑 JSON。

v2.1.3 · 139 个工具 · Windows · ChatGPT Desktop Free · Claude Desktop Free · Claude Code · Codex

如果你是第一次接触这个项目，请从了解这个 Power BI MCP 是什么、何时使用，以及它有意不做什么开始。

安装

无需克隆仓库、手动下载 DLL 或编辑 .mcp.json。 选择适合你的方式。

ChatGPT Desktop Free

运行 docs/INSTALL.md 中经过验证的一键粘贴安装程序， 重启 ChatGPT Desktop，然后打开 Plugins → Personal 并安装 Horizun PBI MCP。无需 OpenAI API 密钥。

Claude Desktop Free

从最新版本 下载 .mcpb 并双击。Claude Desktop 会提供引导运行环境；无需安装 Claude Code，也无需编辑 JSON。它会提示此扩展未经过 Anthropic 验证——它对任何安装在其自有目录之外的内容都会这样提示——然后允许你继续。

Claude Code

claude plugin marketplace add HorizunGroup/horizun-pbi-mcp
claude plugin install horizun-pbi-mcp@horizun

Codex

codex plugin marketplace add HorizunGroup/horizun-pbi-mcp

然后打开 /plugins，选择 Horizun 市场并安装 horizun-pbi-mcp。

桌面版还是 Code？

相同的服务、相同的 139 个工具、相同的本地运行环境——两者都安装后会共用运行环境。根据你的任务选择：Claude Desktop 适合在聊天中使用 Power BI，一键操作，免费版即可。Claude Code 适合构建——它还提供终端、git 和你的仓库，并按需加载工具架构，而不是一次性全部加载。

在新电脑上，经过验证的一键粘贴安装程序无需管理员权限即可准备好前置条件。首次设置只需几分钟：运行 pbi_install_status，直到状态为 ready，重启一次，并确认 139 个 pbi_* 工具已出现。

第一分钟

1. 打开包含任意报表的 Power BI Desktop。
2. 提问：“列出当前打开的 Power BI 模型，并连接到第一个模型。”
3. 提问：“运行一个只读 DAX 查询，返回今年每月的收入。”

如果第 2 步有响应，就说明一切正常。

值得尝试的提问

Audit this PBIP project and explain the highest-risk issues before changing anything.

This measure returns blank for December. Find out why.

Create a report page from this specification, validate it, and show me the layout.

Document every measure in the model and export it to Excel.

提供的功能

领域	功能
实时模型	发现 Desktop 会话、运行 DAX、检查元数据、刷新，并通过 TOM 管理度量值
语义模型	读取和编辑 TMDL 表、列、度量值、关系、角色和计算组
报表创作	创建页面和视觉对象、克隆模板、排列布局、应用主题、书签和交互
转换	将 .pbix 转换为 .pbip、迁移受支持的结构并验证结果
质量	审核模型和报表、记录架构文档、检测失效引用并规范化报表结构
交付	导出经过验证的 PDF、Word、Excel 和 PowerPoint 文件；以只读方式导入 SharePoint 数据

如需查看全部 139 个工具及其风险分类，请参阅工具目录。

为什么可以放心用于实际项目

• 本地优先：Power BI Desktop 通信仅在 localhost 上进行。
• 无遥测，MCP 服务也无需账户。
• 项目写入仅限于当前活动项目目录。
• 每次项目写入都会创建备份，并重新读取以确认写入成功。
• 破坏性工具需要设置 confirm=true。
• JSON 写入是原子操作；无效 JSON 绝不会覆盖有效 JSON。
• 下载的运行时组件固定版本，并经过 SHA-256 验证。
• 日志写入 stderr 或文件，因此 stdout 始终是干净的 JSON-RPC 通道。

完整的保证和故障处理方式：请参阅安全模型和恢复指南。请按照 SECURITY.md 中的说明私下报告漏洞。

要求

• Windows 10 或 11。
• Python 3.10 或更高版本。
• Power BI Desktop——仅实时层需要（DAX、刷新、捕获、渲染检查）。
• 启用了 PBIR 的 .pbip 项目，用于创作报表文件。
• Node.js 20+——仅可选的 Microsoft PBIR 验证器需要。

Claude Code、Codex 和 Power BI Desktop 是外部程序；本项目不会安装它们。没有 Desktop 时，.pbip 工具仍可使用——实时工具则不可用。

已知限制

• Power BI 不会通过其实时本地端点公开页面或视觉对象，因此需要在 Desktop 安全关闭时编辑 PBIR 文件。
• 禁用 mode="both"，以避免同时写入实时模型和磁盘：Desktop 打开与安全编辑 PBIP 项目是互斥状态。
• 此服务不会发布到 Power BI Service，也不会刷新 Power BI Service。
• Power BI 引用的三个 PBIR 架构未由 Microsoft 发布；涉及这些架构的写入会安全失败，而不会猜测。

文档

文档	用途
安装	设置、修复、离线安装和 MCP 客户端注册
教程	从首次连接到报表创作
Power BI MCP 概览	使用场景、边界、安全性和首个工作流
工具目录	按功能和风险分组的所有工具
架构	组件、边界和不变量
安全	威胁模型和运行保证
验证	TMDL/PBIR 验证层和已知限制
迁移指南	从 1.x 到 2.0 的重大变更
贡献	开发工作流和拉取请求要求

开发

git clone https://github.com/HorizunGroup/horizun-pbi-mcp.git
cd horizun-pbi-mcp
python -m pip install -e .
python scripts/fetch_libs.py
python scripts/fetch_pbir_schemas.py
python scripts/doctor.py

提交拉取请求前：

python -m pytest -q
python scripts/doctor.py
python -m tests.contract_utils

MCP 合约已冻结，并通过 tests/golden/tools_v1.json 进行检查。真实的 .pbix、.pbip、凭据、DLL、输出文件和备份绝不会提交。有关仓库不变量，请参阅 AGENTS.md。

学会指挥它

Horizun Hub 以西班牙语授课，教你如何在真实的施工和设计工作中指挥 AI Agent，以及如何在签字前审核它们交付的内容。本 MCP 的课程是 Opera agentes en Power BI：围绕真实施工工作的短课程，并提供可验证的证书。

刚接触 Agent？Opera agentes de IA desde cero 的第 1 级课程可免费学习，只需注册账号。

许可证

Apache License 2.0。请参阅 LICENSE 和 NOTICE。

MCP 注册表

此软件包以以下服务名称发布。注册表会从 PyPI 软件包的 README 中读取此行，以确认发布元数据的人同时拥有该软件包，因此此行必须放在这里，而不能只放在 .mcp/server.json 中。

mcp-name: io.github.HorizunGroup/horizun-pbi-mcp