🚀 PBIXRay MCP 服务器

PBIXRay MCP 服务器是专为 PBIXRay 设计的 Model Context Protocol (MCP) 服务器。它允许用户通过 MCP 协议与 PBIX 文件进行交互，为处理 PBIX 文件提供了便捷的途径。

🚀 快速开始

示例脚本

from pbixray_mcp_server import PbixMcpServer

# 初始化 MCP 服务器
server = PbixMcpServer()

# 加载并解析 PBIX 文件
with open("demo/AdventureWorks Sales.pbix", "rb") as file:
    server.load_file(file=file)

# 获取可用工作表
print(server.worksheets())

# 获取数据集信息
print(server.dataset_info())

# 下载数据到 CSV 格式
data = server.download_dataset()
data.to_csv("output.csv")

使用 MCP 检查器进行交互式测试

# 启动 MCP 检查器
mcp dev src/pbixray_server.py

这将启动一个交互式会话，您可以在其中调用工具并测试响应。

✨ 主要特性

• 支持文件格式：.pbix
• 核心功能：
  • 加载和解析 PBIX 文件
  • 获取工作表信息
  • 检索数据集
  • 访问字段属性
  • 获取 DAX 表达式（计算列、措施）
  • 处理数据切片
  • 下载数据到 CSV 或 Excel 格式

📦 安装指南

使用 pip 安装

pip install pbixray-mcp-server

开发模式安装

1. 克隆仓库：

   git clone https://github.com/username/pbixray-mcp.git
   cd pbixray-mcp
   

2. 使用开发模式安装：

   pip install -e .
   

3. 安装依赖项（若从源代码安装）：

   python -m venv venv
   source venv/bin/activate  # 在 Windows 上使用：venv\Scripts\activate
   pip install mcp pbixray numpy
   

📚 详细文档

项目结构

pbixray-mcp/
├── README.md            - 该文件
├── INSTALLATION.md      - 详细的安装说明
├── src/                 - 源代码
│   ├── __init__.py
│   └── pbixray_server.py
├── tests/               - 测试脚本
│   ├── __init__.py
│   ├── conftest.py
│   ├── test_server.py
│   └── test_with_sample.py
├── examples/            - 示例脚本和配置
│   ├── demo.py
│   └── config/
├── demo/                - 样例 PBIX 文件
│   ├── README.md
│   └── AdventureWorks Sales.pbix
└── docs/                - 额外文档
    └── ROADMAP.md

🤝 贡献

欢迎任何贡献！

🙏 致谢

• Hugoberry - 原始 PBIXRay 库的作者
• rusiaaman - WCGW（此 MCP 完全由 Claude 使用 WCGW 编写）

📄 许可证

MIT License