Pbixray MCP Server

🚀 PBIXRay MCP 服務器

PBIXRay MCP 服務器是一款基於 模型上下文協議 (MCP) 的工具，它能夠與 PBIX 文件進行交互，具備數據提取、元數據查詢等多種實用功能。

🚀 快速開始

PBIXRay MCP 服務器可用於與 PBIX 文件交互，提供了數據提取、元數據查詢等功能。您可以按照以下安裝步驟進行操作，然後使用工具列表中的工具開展相關工作。

✨ 主要特性

• 支持的文件格式：支持打開和分析 .pbix 文件。
• 數據提取：可以從 PBIX 文件中提取數據並進行處理。
• 元數據查詢：提供對 PBIX 文件中包含的表結構、字段信息等元數據的查詢功能。

📦 安裝指南

安裝

您可以使用以下命令安裝 PBIXRay MCP 服務器：

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
   

💻 使用示例

基礎用法

以下是 MCP 服務器支持的主要工具及其使用說明：

高級用法

開發與測試

倉庫中包含一些示例文件和測試腳本，幫助您快速上手：

# 使用示例文件進行測試
python tests/test_with_sample.py

# 運行交互式演示
python examples/demo.py

# 針對特定功能的測試
python test_pagination.py
python test_metadata_fix.py

開發模式

在開發過程中，可以使用 MCP 檢查器：

# 先激活您的環境
source venv/bin/activate

# 運行 MCP 檢查器
mcp dev src/pbixray_server.py

這將啟動一個交互式會話，您可以在此調用工具並測試響應。

📚 詳細文檔

項目結構

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

📄 許可證

本項目使用 MIT 許可證。

👏 貢獻

歡迎任何貢獻！

🙏 致謝

• Hugoberry - PBIX 文件分析工具的作者。
• 開源社區的支持者。