⚠️Alpha version - APIと動作は通知なしで変更される場合があります。

Power BI デスクトップ MCP Server では、Claude (または MCP クライアント) は、自然言語を使用して、実行中の Power BI デスクトップインスタンスに話します。 Model Context プロトコルを Tabular オブジェクトモデルに橋渡しするので、チャットを離れずに DAX を検査、最適化、作成できます。

インストール

ステップバイステップの設定(パワーBI前提条件、.NETライブラリ、環境変数)は、INSTALLATION.mdに住んでいます。

ローカル開発のため:

クイック例

現在のPower BIモデルの表をリストします。

知識ベースへの輸出措置:

式でオプティマイザを実行します。

設定

• [.env.exampleを.env]にコピーし、Microsoft Analysis Services DLLが自動検出されていない場合は[[TOM_DLL_PATH]を設定してください。 オプション変数は[[LOG_LEVEL, MCP_KNOWLEDGE_BASE], [POWERBI_WORKSPACE_NAME]を含みます。

• Claudeデスクトップ(または任意のMCPホスト)にCCLエントリーポイントを追加します。

• CLI は python -m powerbi_mcp.server の周りの細いラッパーなので、デプロイやデバッグのための呼び出し作業も行います。

##特徴

• DAXコード生成と測定作成
• 測定およびテーブルメタデータ検査
• DAXオプティマイザとルールベースの提案

Power BI Desktop MCP Server

⚠️ Alpha version – APIs and behaviours may change without notice.

Power BI Desktop MCP Server lets Claude (or any MCP client) talk to a running Power BI Desktop instance using natural language. It bridges the Model Context Protocol to the Tabular Object Model so you can inspect, optimize, and author DAX without leaving chat.

Installation

Step-by-step setup (Power BI prerequisites, .NET libraries, environment variables) lives in INSTALLATION.md.

For local development:

pip install -e .
# or install from the current directory:
pip install .

Quick Example

List the tables in your current Power BI model:

python examples/list_model_info.py --include-columns

Export measures to the knowledge base:

python examples/export_measures_to_knowledge_base.py --project "Executive Dashboard"

Run the optimizer on an expression:

python examples/optimize_dax.py --expr "CALCULATE(SUM(Sales[Amount]), FILTER(ALL(Date), Date[Year] = 2024))"

Configuration

• Copy .env.example to .env and set TOM_DLL_PATH if the Microsoft Analysis Services DLLs are not auto-detected. Optional variables include LOG_LEVEL, MCP_KNOWLEDGE_BASE, and POWERBI_WORKSPACE_NAME.

• Add the CLI entry point to Claude Desktop (or any MCP host):

  {
    "mcpServers": {
      "powerbi": {
        "command": "powerbi-mcp-server",
        "args": []
      }
    }
  }
  

• The CLI is a thin wrapper around python -m powerbi_mcp.server, so either invocation works for deployments and debugging.

Features

• DAX code generation and measure creation
• Measure and table metadata inspection
• DAX optimizer with rule-based suggestions
• TMDL import/export helpers
• Knowledge base bridge for storing curated measures
• Example scripts for quick automation (examples/ directory)

Known Issues

• Power BI visuals live outside the XMLA endpoint, so visual creation/editing is not supported.
• The server connects to the most recently opened Power BI Desktop workspace; multiple instances are not yet multiplexed.
• Write operations require the Power BI model to allow external tools and, in some scenarios, elevated permissions.
• pythonnet relies on local Microsoft Analysis Services DLLs; misconfigured TOM_DLL_PATH is the most common setup failure.

Contributing

Pull requests are welcome. Please:

1. Open an issue describing the change if it alters behaviour or APIs.
2. Keep additions formatted with ruff/black style conventions (if configured) and include type hints.
3. Add or update example scripts/tests where it helps illustrate new functionality.