PBIXRay MCP Server
2025.04.09
0
PythonPower BI 分析数据模型探索查询语言访问开发效率数据库
PBIXRay MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于与 Power BI (.pbix) 文件进行交互。它提供了多种工具和功能，帮助用户分析和探索 Power BI 数据模型。核心功能包括加载和分析 PBIX 文件、数据模型探索、查询语言访问以及数据结构分析。适用于需要深入分析 Power BI 文件的数据分析师和开发人员。
View on GitHub
Overview
基本能力
产品定位
PBIXRay MCP Server 是一个专门用于分析和探索 Power BI (.pbix) 文件的工具，通过 MCP 协议提供丰富的交互功能。
核心功能
- 加载和分析 PBIX 文件：支持加载和解析 Power BI 文件。
- 数据模型探索：
- 列出模型中的表格
- 检索模型元数据
- 检查模型大小
- 获取模型统计信息
- 获取全面的模型摘要
- 查询语言访问：
- 查看 Power Query (M) 代码
- 访问 M 参数
- 探索 DAX 计算表
- 查看 DAX 度量
- 检查 DAX 计算列
- 数据结构分析：
- 检索模式信息
- 分析表格关系
- 通过分页访问表格内容
适用场景
- 数据分析师需要深入分析 Power BI 文件的结构和内容。
- 开发人员需要自动化处理 Power BI 文件。
- 团队需要共享和协作分析 Power BI 模型。
工具列表
| 工具名称 | 类别 | 描述 |
|---|---|---|
load_pbix_file |
Core | 加载 Power BI (.pbix) 文件进行分析 |
get_tables |
Model | 列出模型中的所有表格 |
get_metadata |
Model | 获取 Power BI 配置的元数据 |
get_power_query |
Query | 显示用于数据转换的所有 M/Power Query 代码 |
get_m_parameters |
Query | 显示所有 M 参数的值 |
get_model_size |
Model | 获取模型的大小（字节） |
get_dax_tables |
Query | 查看 DAX 计算表 |
get_dax_measures |
Query | 通过表格或度量名称过滤访问 DAX 度量 |
get_dax_columns |
Query | 通过过滤选项访问计算列的 DAX 表达式 |
get_schema |
Structure | 获取数据模型模式和列类型的详细信息 |
get_relationships |
Structure | 获取数据模型关系的详细信息 |
get_table_contents |
Data | 通过分页检索指定表格的内容 |
get_statistics |
Model | 获取模型的统计信息（可选过滤） |
get_model_summary |
Model | 获取当前 Power BI 模型的全面摘要 |
常见问题解答
- 路径问题：在 WSL 中使用时，Windows 路径无法直接访问，需转换为 WSL 路径（如
/mnt/c/Users/name/Downloads/file.pbix）。 - 工具禁用：可以通过
--disallow参数禁用特定工具以增强安全性。 - 分页设置：可通过
--max-rows和--page-size参数调整返回的行数和分页大小。
使用教程
使用依赖
- 确保已安装 Python 和 pip。
- 创建并激活虚拟环境：
bash python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
安装教程
- 通过 pip 安装：
bash pip install pbixray-mcp-server - 开发模式安装（可选）：
bash git clone https://github.com/username/pbixray-mcp.git cd pbixray-mcp pip install -e .
调试方式
- 运行测试脚本：
bash python tests/test_with_sample.py - 使用 MCP Inspector 进行交互式测试：
bash mcp dev src/pbixray_server.py - 检查示例文件：
bash python examples/demo.py