Power Bi Mcp Server

Power BI MCP 服务

一个模型上下文协议（MCP）服务，可让 AI 助手以编程方式与 Power BI 工作区、数据集、报表和仪表板交互。

🚀 功能

• 工作区管理：列出和管理 Power BI 工作区
• 报表操作：访问、克隆、导出和重新绑定报表
• 数据集管理：执行 DAX 查询、刷新数据集、管理计划
• 仪表板访问：列出仪表板并与之交互
• 推送数据集：创建和管理包含实时数据的推送数据集
• 身份验证：使用 Microsoft Entra ID 进行安全的 OAuth2 身份验证

📋 先决条件

• Node.js（v18 或更高版本）
• npm 或 yarn
• Power BI Pro 或 Premium 许可证
• Microsoft Entra ID 应用注册
• 兼容 MCP 的 AI 助手（Claude Desktop 等）

🔧 安装

1. 克隆仓库：

git clone https://github.com/michaelmckinleyconsulting/powerbi-mcp-server.git
cd powerbi-mcp-server

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

⚙️ 配置

1. Microsoft Entra ID 设置

1. 在 Azure Portal 中注册应用程序
2. 为 Power BI Service 配置 API 权限
3. 记录以下信息：
   • Client ID
   • Tenant ID
   • Client Secret（如果使用仅应用身份验证）

2. 环境变量

在根目录中创建 .env 文件（模板见 .env.example）：

PBI_PUBLIC_CLIENT_ID=your_client_id
PBI_TENANT_ID=your_tenant_id  # Optional, defaults to 'common'
PBI_SCOPES=https://analysis.windows.net/powerbi/api/.default  # Optional, or specify custom scopes

注意：此服务使用带 PKCE 的 Authorization Code 流程（无需客户端密钥）。请使用以下重定向 URI 配置 Azure 应用：

• http://localhost
• http://127.0.0.1

3. MCP 配置

将以下内容添加到 MCP 客户端配置中：

Claude Desktop

{
  "mcpServers": {
    "powerbi": {
      "command": "node",
      "args": ["path/to/powerbi-mcp-server/dist/index.js"],
      "env": {
        "PBI_PUBLIC_CLIENT_ID": "your_client_id",
        "PBI_TENANT_ID": "your_tenant_id"
      }
    }
  }
}

VS Code MCP Extension

{
  "mcp.servers": {
    "powerbi": {
      "command": "node",
      "args": ["path/to/powerbi-mcp-server/dist/index.js"],
      "transport": "stdio",
      "env": {
        "PBI_PUBLIC_CLIENT_ID": "your_client_id"
      }
    }
  }
}

📖 用法

基本操作

完成配置后，你的 AI 助手可以：

• 列出工作区：“显示我的所有 Power BI 工作区”
• 执行 DAX：“运行 DAX 查询，获取各地区的销售额”
• 导出报表：“将季度报表导出为 PDF”
• 刷新数据集：“刷新销售数据集”
• 管理访问权限：“将 [email protected] 添加到 Analytics 工作区”

示例提示词

"List all reports in my Sales workspace"
"Execute this DAX query against the Finance dataset: EVALUATE SUMMARIZE(...)"
"Export the Monthly KPI report to PowerPoint"
"Show me the refresh history for the Customer dataset"
"Create a push dataset for real-time monitoring"

🔐 身份验证

此服务支持两种身份验证方式：

1. 交互式（推荐）：用户通过浏览器登录
2. 仅应用：使用客户端凭据（需要管理员同意）

首次运行时，服务会提示你通过默认浏览器进行身份验证。

📁 项目结构

powerbi-mcp-server/
├── src/
│   ├── index.ts           # Main server entry point
│   ├── auth/              # Authentication logic
│   ├── handlers/          # Request handlers
│   ├── types/             # TypeScript definitions
│   └── utils/             # Utility functions
├── dist/                  # Compiled JavaScript (git-ignored)
├── package.json
├── tsconfig.json
└── README.md

🛠️ 开发

在开发模式下运行

npm run dev

运行测试

npm test

构建生产版本

npm run build

📊 支持的 Power BI 操作

工作区（组）

• 列出工作区
• 获取工作区用户
• 添加/移除用户

报表

• 列出报表
• 获取报表元数据
• 克隆报表
• 导出为多种格式（PDF、PPTX、PNG）
• 重新绑定到其他数据集

数据集

• 列出数据集
• 执行 DAX 查询
• 触发刷新
• 管理刷新计划
• 获取刷新历史记录

仪表板

• 列出仪表板
• 获取仪表板磁贴

推送数据集

• 创建推送数据集
• 向表中添加行
• 清除表数据

🔧 故障排除

常见问题

1. 身份验证失败：确保 Azure 应用注册具有正确的 Power BI 权限
2. 未找到工作区：确认你的帐户有权访问 Power BI 工作区
3. DAX 查询失败：检查数据集权限和查询语法
4. 导出超时：大型报表可能需要较长时间；服务会处理异步轮询

调试模式

启用详细日志记录：

DEBUG=powerbi:* node dist/index.js

📄 许可证

本项目根据修改版 MIT 许可证（含 Commons Clause）以源代码可用方式提供，详情请参阅 LICENSE 文件。

非商业用途：个人、教育和公司内部用途均可免费使用。

商业用途：需要单独的商业许可证。商业授权事宜请联系 [[email protected]]。

由于存在商业限制，本项目并非经 OSI 批准的“开源”项目，但社区可将其充分用于非商业目的。

🤝 参与贡献

欢迎贡献！请注意：

1. 参与贡献即表示您同意，您的贡献将采用相同的许可证授权
2. 对于重大变更，请先提交 issue 进行讨论
3. 请确保所有测试均通过，并为新功能添加测试

💬 支持

• 问题反馈：GitHub Issues
• 商业支持：[[email protected]]
• 文档：Wiki

🙏 致谢

• 基于 Model Context Protocol 规范构建
• 使用 Microsoft Power BI REST API
• 灵感来自 MCP 社区

---

注意：这不是 Microsoft 官方产品。Power BI 是 Microsoft Corporation 的商标。