Jonaolden Pbixray MCP Server

🚀 PBIXRay MCP サーバー

PBIXRay 用に設計された Model Context Protocol (MCP) サーバーです。
このサーバーを使用すると、MCP プロトコルを介して PBIX ファイルとやり取りすることができます。

✨ 主な機能

• サポートするファイル形式：.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
   

🚀 クイックスタート

サンプルスクリプト

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

これにより、ツールを呼び出して応答をテストできる対話型セッションが開始されます。

📚 ドキュメント

プロジェクト構造

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