Pbixray MCP Server

🚀 PBIXRay MCP サーバー

PBIXRay MCP サーバーは、モデルコンテキストプロトコル (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

🤝 貢献

いかなる貢献も歓迎します！

🙏 謝辞

• Hugoberry - PBIX ファイル分析ツールの作者。
• オープンソースコミュニティの支援者の皆様。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。