Horizun PBI MCP

Horizun PBI MCP

やりたいことを伝えるだけで、Power BI レポートを作成・修正できます。 平易な言葉で依頼すると、サーバーが DAX を実行し、モデルを編集し、レポートページを作成したうえで、作業結果を自ら確認します。

ライセンスも API キーも有料プランも不要

お使いの Windows マシン上でローカルプロセスとして動作するため、無料アプリだけで十分です。無料プランのChatGPT DesktopまたはClaude Desktopにインストールして、すぐに使い始められます。OpenAI や Anthropic の API キーも、サブスクリプションも、当社のサーバーも必要ありません。Power BI Desktop も無料です。ワンクリックでインストールでき、実行環境も自動で準備されるため、Python も JSON の編集も不要です。

v2.1.3 · 139 個のツール · Windows · ChatGPT Desktop Free · Claude Desktop Free · Claude Code · Codex

このプロジェクトを初めてお使いですか？この Power BI MCP の概要、活用方法、意図的に対応していないことから始めてください。

インストール

リポジトリのクローン、DLL の手動ダウンロード、.mcp.json の編集は不要です。お使いの環境に合った方法を選んでください。

ChatGPT Desktop Free

docs/INSTALL.mdに記載された検証済みのワンペーストインストーラーを実行し、ChatGPT Desktop を再起動してから、Plugins → Personalを開き、Horizun PBI MCPをインストールします。OpenAI API キーは不要です。

Claude Desktop Free

最新リリースから.mcpbをダウンロードし、ダブルクリックします。Claude Desktop がブートストラップ用の実行環境を提供するため、Claude Code のインストールも JSON の編集も不要です。拡張機能がAnthropic によって検証されていませんという警告が表示されます。これは、独自のディレクトリ外にインストールされたものに対して表示される警告です。そのまま続行できます。

Claude Code

claude plugin marketplace add HorizunGroup/horizun-pbi-mcp
claude plugin install horizun-pbi-mcp@horizun

Codex

codex plugin marketplace add HorizunGroup/horizun-pbi-mcp

次に/pluginsを開き、Horizunマーケットプレイスを選択して、horizun-pbi-mcpをインストールします。

Desktop と Code、どちらを使う？

同じサーバー、同じ139個のツール、同じローカル実行環境を使います。両方をインストールしても、実行環境は共有されます。用途に応じて選んでください。チャットでワンクリック操作し、無料プランで Power BI を使うならClaude Desktop。ターミナル、git、リポジトリを利用して開発するならClaude Codeです。Claude Code はツールのスキーマを一度にすべてではなく、必要に応じて読み込みます。

新しい PC では、検証済みのワンペーストインストーラーを使うと、管理者権限なしで前提条件を準備できます。初期設定には数分かかります。pbi_install_statusをreadyになるまで実行し、1回再起動してから、139個のpbi_*ツールが表示されることを確認してください。

最初の1分

1. 任意のレポートを開いた状態で、Power BI Desktop を起動します。
2. *「開いている Power BI モデルを一覧表示して、最初のモデルに接続してください。」*と依頼します。
3. *「今年の月別売上を返す、読み取り専用の DAX クエリを実行してください。」*と依頼します。

ステップ2で応答があれば、すべて正常に動作しています。

依頼してみること

Audit this PBIP project and explain the highest-risk issues before changing anything.

This measure returns blank for December. Find out why.

Create a report page from this specification, validate it, and show me the layout.

Document every measure in the model and export it to Excel.

提供する機能

領域	機能
ライブモデル	Desktop セッションの検出、DAX の実行、メタデータの調査、更新、TOM を使用したメジャーの管理
セマンティックモデル	TMDL のテーブル、列、メジャー、リレーションシップ、ロール、計算グループの読み取りと編集
レポート作成	ページやビジュアルの作成、テンプレートの複製、レイアウトの調整、テーマ、ブックマーク、インタラクションの適用
変換	.pbix を .pbip に変換し、サポート対象の構造を移行して結果を検証
品質	モデルとレポートの監査、スキーマの文書化、壊れた参照の検出、レポート構造の正規化
成果物の出力	検証済みの PDF、Word、Excel、PowerPoint 成果物のエクスポート、SharePoint データの読み取り専用取り込み

139 個すべてのツールとリスク分類については、ツールカタログを参照してください。

実際の作業に安心して使用できる理由

• ローカル優先：Power BI Desktop との通信は localhost 内にとどまります。
• テレメトリはなく、MCP サーバーにアカウントは必要ありません。
• プロジェクトへの書き込みは、アクティブなプロジェクトディレクトリ内にとどまります。
• プロジェクトへの書き込みごとにバックアップを作成し、書き込みが反映されたことを再読み込みして確認します。
• 破壊的なツールには confirm=true が必要です。
• JSON の書き込みはアトミックに行われます。有効な JSON が無効な JSON で上書きされることはありません。
• ダウンロードされるランタイムコンポーネントはバージョンが固定され、SHA-256 で検証されます。
• ログは stderr またはファイルに出力されるため、stdout はクリーンな JSON-RPC チャネルとして保たれます。

保証の詳細と障害時の動作については、セキュリティモデルと復旧ガイドを参照してください。脆弱性はSECURITY.mdの説明に従って非公開で報告してください。

要件

• Windows 10 または 11。
• Python 3.10 以降。
• Power BI Desktop — ライブレイヤー（DAX、更新、キャプチャ、レンダリング確認）でのみ必要です。
• レポートファイルの作成には、PBIR が有効な .pbip プロジェクトが必要です。
• Node.js 20 以降 — オプションの Microsoft PBIR バリデーターにのみ必要です。

Claude Code、Codex、Power BI Desktop は外部プログラムであり、このプロジェクトによってインストールされることはありません。Desktop がなくても .pbip ツールは動作しますが、ライブツールは動作しません。

既知の制限

• Power BI はライブローカルエンドポイント経由でページやビジュアルを公開しないため、Desktop を安全に閉じた状態で PBIR ファイルを編集します。
• ライブとディスクへの同時書き込みを行う mode="both" は無効になっています。Desktop が開いている状態と、PBIP プロジェクトを安全に編集できる状態は両立しません。
• サーバーは Power BI Service への公開や更新を行いません。
• Power BI が参照する 3 つの PBIR スキーマは Microsoft によって公開されていません。該当する書き込みは推測で進めず、安全側に停止します。

ドキュメント

ドキュメント	目的
インストール	セットアップ、修復、オフラインインストール、MCP クライアントの登録
チュートリアル	初回接続からレポート作成まで
Power BI MCP の概要	ユースケース、範囲、安全性、最初のワークフロー
ツールカタログ	機能とリスク別に分類したすべてのツール
アーキテクチャ	コンポーネント、境界、不変条件
セキュリティ	脅威モデルと運用上の保証
検証	TMDL／PBIR の検証レイヤーと既知の制限
移行ガイド	1.x から 2.0 への破壊的変更
コントリビューション	開発ワークフローとプルリクエストの要件

開発

git clone https://github.com/HorizunGroup/horizun-pbi-mcp.git
cd horizun-pbi-mcp
python -m pip install -e .
python scripts/fetch_libs.py
python scripts/fetch_pbir_schemas.py
python scripts/doctor.py

プルリクエストを作成する前に：

python -m pytest -q
python scripts/doctor.py
python -m tests.contract_utils

MCP コントラクトは凍結されており、tests/golden/tools_v1.json と照合して確認されます。実際の .pbix、.pbip、認証情報、DLL、出力、バックアップはコミットしないでください。リポジトリの不変条件については、AGENTS.mdを参照してください。

エージェントへの指示方法を学ぶ

Horizun Hub では、実際の建設・設計業務で AI エージェントに指示する方法と、成果物に署名する前にその内容を確認する方法を、スペイン語で学べます。この MCP のコースは Opera agentes en Power BI です。実際の建設業務を扱う短いレッスンと、検証可能な修了証が用意されています。

エージェントを使うのは初めてですか？Opera agentes de IA desde cero のレベル 1 は、アカウントを作成すれば無料で受講できます。

ライセンス

Apache License 2.0。LICENSE と NOTICE をご覧ください。

MCP レジストリ

このパッケージは、以下のサーバー名で公開されているものです。レジストリは、メタデータの公開者がパッケージの所有者でもあることを確認するため、この行を PyPI パッケージの README から読み取ります。そのため、この行は .mcp/server.json だけでなく、ここにも記載する必要があります。

mcp-name: io.github.HorizunGroup/horizun-pbi-mcp