Jonaolden Pbixray MCP Server

🚀 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