Power BI 통합 MCP

AI 기반 Power BI 의미 모델 엔지니어링과 PBIR/PBIP 보고서 작성을 위한 단일 MCP 인터페이스입니다.

의미 모델 작업은 Microsoft의 Power BI Modeling MCP를 통해 실행됩니다. 이 프로젝트는 단일 MCP 서버 뒤에 통합 오케스트레이션, 로컬 PBIR/PBIP 보고서 작성, 안전 제어, 진단, stdio/HTTP 전송을 추가합니다.

상태: Early Release / Public Preview - v0.2.0

Power BI는 Microsoft의 제품입니다. 이 저장소는 Microsoft가 소유한 것이 아니며, Microsoft의 모델링 실행 파일을 번들로 포함하지 않으며, Power BI Desktop을 완전히 대체하지 않습니다.

왜 이 프로젝트인가

Power BI 자동화는 현재 두 가지 서로 다른 계층에 걸쳐 있습니다:

• Power BI Desktop 또는 호환 가능한 테이블 형식 모델에 대한 의미 모델 엔지니어링

• 디스크의 PBIR/PBIP 보고서 정의 편집

이 프로젝트는 두 계층을 통합하여 AI 클라이언트가 로컬 안전 제어를 준수하면서 단일 MCP 도구 카탈로그를 통해 보고서와 모델을 검사, 검증, 수정할 수 있게 합니다.

Related MCP server: powerbi-mcp-local

Microsoft의 Modeling MCP와 어떻게 다른가

Microsoft의 Modeling MCP는 연결, 테이블, 열, 측정값, 관계, DAX, 역할, 파티션, TMDL 및 관련 메타데이터 작업과 같은 의미 모델 작업에 중점을 둡니다.

powerbi-unified-mcp는 해당 업스트림 기능을 유지하면서 다음을 추가합니다:

• 로컬 PBIR/PBIP 보고서 프로젝트 검색 및 수명 주기 관리

• 페이지 및 시각적 개체 작성

• 필드 바인딩 및 서식 지정

• 테마, 필터, 상호 작용, 검증, 체크포인트, 실행 취소

• 보고서 및 모델 작업을 위한 단일 통합 MCP 표면

• 로컬 정책 적용, 진단, 감사 로깅, 기능 보고

현재 범위

v0.2.0이 현재 할 수 있는 작업:

• PBIR/PBIP 보고서 프로젝트 검색 및 열기

• 보고서 페이지 생성, 이름 변경, 복제, 삭제

• 지원되는 시각적 개체 생성, 검사, 이동, 크기 조정, 유형 변경, 바인딩, 서식 지정

• 테마 적용, 필터 설정, 시각적 개체 상호 작용 구성, 보고서 구조 검증

• 보고서 체크포인트 생성, 체크포인트 복원, 최근 보고서 변경 사항 실행 취소

• Microsoft의 Modeling MCP에서 의미 모델 작업 프록시

• 업스트림 도구 계열을 통한 로컬 Power BI Desktop 검색, 연결, DAX 검증/실행, 임시 측정값 CRUD 지원

• 공식 MCP SDK를 사용한 stdio 및 HTTP 전송 지원

아직 지원하지 않는 기능:

• PBIR/PBIP 프로젝트 없이 직접 라이브 .pbix 캔버스 수정

• 완전한 Power BI Service 또는 Fabric 수명 주기 관리

• 책갈피 수정 또는 전체 버튼/탐색 작성

• 완전한 조건부 서식 추상화

• 모든 네이티브 또는 사용자 지정 Power BI 시각적 개체 지원

• 완성된 제품으로서의 호스팅 다중 사용자 배포, 인증 또는 RBAC

아키텍처

flowchart TD
    A[AI Client / MCP Host] --> B[Power BI Unified MCP]

    B --> C[PBIR/PBIP Report Authoring Engine]
    B --> D[Microsoft Power BI Modeling MCP]

    C --> E[Pages]
    C --> F[Visuals]
    C --> G[Field Bindings]
    C --> H[Formatting]
    C --> I[Themes]
    C --> J[Filters & Interactions]
    C --> K[Validation & Checkpoints]

    D --> L[Power BI Desktop / Fabric Semantic Model]

    L --> M[Tables & Columns]
    L --> N[Measures & DAX]
    L --> O[Relationships]
    L --> P[Partitions]
    L --> Q[RLS / Security Roles]
    L --> R[Calculation Groups]
    L --> S[TMDL / TMSL]

일반 언어로 설명:

• 보고서 작성은 이 저장소에서 구현되며 디스크의 PBIR/PBIP 프로젝트에서 작동합니다.

• 의미 모델 엔지니어링은 Microsoft의 외부 Modeling MCP에 위임된 후 호환성 검사, 정책 적용, 진단, 감사 로깅으로 래핑됩니다.

자세한 내용: 아키텍처

빠른 설치

git clone <repo-url>
cd powerbi-unified-mcp
npm install
npm run build
npm test

Microsoft Modeling MCP가 자동 검색되지 않는 경우:

$env:POWERBI_MODELING_MCP_EXE="C:\path\to\powerbi-modeling-mcp.exe"

stdio 모드에서 실행:

node server.js

HTTP 모드에서 실행:

node server.js --transport=http --port=8765

상태 확인:

curl http://127.0.0.1:8765/health

전체 설정: 설치

MCP 클라이언트 예시

• 일반 MCP 클라이언트

• Codex

• Claude

• ChatGPT

예시 프롬프트

현재 열려 있는 Power BI Desktop 모델을 검사하고 테이블, 측정값, 관계를 요약해 줘.

Total Profit 측정값을 만들고 DAX를 검증한 다음 쿼리하여 작동하는지 확인해 줘.

이 PBIR 보고서 프로젝트를 열고 보고서 페이지, 시각적 개체, 활성 테마를 나열해 줘.

Total Sales 및 Profit 카드, 월간 매출 추이, 카테고리별 매출 막대 차트, Region 슬라이서가 포함된 Executive Overview 보고서 페이지를 만들어 줘.

Sales by Category 시각적 개체를 찾아 클러스터형 세로 막대형 차트로 변경하고, 페이지 오른쪽으로 이동한 후 보고서를 검증해 줘.

현재 PBIR 보고서를 검증하고 변경하기 전에 오류를 설명해 줘.

보안

보안 모드:

• read-only

• safe-write

• full

중요한 기본 사항:

• 보고서 변경은 구성된 파일 시스템 루트로 제한됩니다

• 대부분의 보고서 쓰기는 기본적으로 자동 체크포인트를 생성합니다

• 파괴적이거나 보안에 민감한 모델링 작업은 정책으로 제어됩니다

• HTTP 모드는 로컬 우선으로 취급되어야 하는 개발 전용 수단입니다

인증, TLS, 리버스 프록시, 로깅, 네트워크 보호 없이 full 모드를 노출하지 마십시오.

자세한 내용: 보안 모델

요구 사항

• Node.js >=20

• Windows는 라이브 Power BI Desktop 통합을 위한 기본 지원 환경입니다

• 의미 모델 기능에는 Microsoft의 업스트림 Modeling MCP가 필요합니다

• 지원되는 최소 업스트림 Modeling MCP 버전: 0.2.0

• v0.2.0은 실제 Power BI Desktop 모델에 대해 DAX 검증/실행 및 임시 측정값 CRUD를 포함한 연결, DAX 검증/실행, 임시 측정값 CRUD를 검증했습니다

자세한 내용: Modeling MCP 호환성

제한 사항

• 직접 .pbix 캔버스 변경은 보고서 작성 경로가 아닙니다. PBIR/PBIP 프로젝트를 사용하십시오.

• 의미 모델 기능은 Microsoft의 업스트림 실행 파일에 의존합니다.

• 보고서 시각적 개체 지원 범위는 상당하지만 완전하지는 않습니다.

자세한 내용: 제한 사항

문서

• README

• 빠른 시작

• Power BI Desktop

• 의미 모델링

• 보고서 작성

• 시각적 개체 카탈로그

• 구성 참조

• 도구 참조

• 생성된 기능 매트릭스

• 문제 해결

• 로드맵

기여

기여자 설정, 테스트 흐름, 메타데이터 생성, 릴리스 기대 사항: CONTRIBUTING.md

라이선스

MIT. LICENSE를 참조하십시오.