Power BI 모델링 MCP SSE 브리지

이 프로젝트는 공식 Microsoft Power BI 모델링 MCP 서버를 위한 고성능 SSE(Server-Sent Events) 브리지입니다. 로컬 stdio 파이핑 없이 모든 언어(Laravel, Python, Go)에서 Power BI 의미론적 모델과 원활하게 URL 기반으로 상호 작용할 수 있습니다.

🔥 주요 혁신 기능

• 자동 인증(토큰 주입): 관리자 자격 증명을 사용하여 Azure ROPC 흐름을 자동으로 수행하고 액세스 토큰을 주입합니다. 결과: 서버에서 브라우저 팝업 없음

• 동적 바이너리 해결: OS 및 CPU 아키텍처를 자동으로 감지하여 올바른 Microsoft MCP 바이너리를 실행합니다.

• Laravel 컨텍스트 주입: URL 쿼리 매개변수를 통해 작업 영역(Workspace) 및 데이터 세트(Dataset) ID를 전달하여 세션별 컨텍스트를 유지합니다.

• 웹 지원: Power BI를 위한 맞춤형 AI 채팅 인터페이스를 구축하는 데 최적입니다.

Related MCP server: powerbi-mcp-proxy

🛠️ 설치 및 빠른 시작

1. 요구 사항

• Node.js v18 이상.

• Power BI 관리자 계정(마스터 사용자) 또는 서비스 주체(Service Principal).

2. 설정

git clone https://github.com/nusagates/mcp_pbi.git
cd mcp_pbi
npm install

3. 구성

템플릿에서 .env 파일을 생성합니다:

cp .env.example .env

MS_PBI_... 자격 증명을 입력합니다. 중요: 브라우저 없이 비밀번호 기반 로그인이 작동하려면 Azure 앱 등록 -> 인증 설정에서 **"공용 클라이언트 흐름 허용(Allow public client flows)"**을 활성화해야 합니다.

4. 실행

npm start

브리지는 http://localhost:3000/sse에서 활성화됩니다.

🔗 Laravel 통합 예시

Laravel의 Http 파사드를 사용하여 브리지와 상호 작용하는 방법:

use Illuminate\Support\Facades\Http;

// 1. Establish connection context (via Browser/SSE Client)
// URL: http://localhost:3000/sse?workspace_id=abc&dataset_id=123

// 2. Execute a Tool through the bridge
$response = Http::post("http://localhost:3000/messages?sessionId=YOUR_SESSION_ID", [
    "jsonrpc" => "2.0",
    "id" => 1,
    "method" => "tools/call",
    "params" => [
        "name" => "execute_dax_query",
        "arguments" => [
            "query" => "EVALUATE TOPN(10, 'YourTable')"
        ]
    ]
]);

return $response->json();

🛡️ Power BI 권한 체크리스트

• [ ] Azure 포털: Tenant.Read.All 권한이 있는 앱 등록이 존재해야 합니다.

• [ ] Power BI 관리자: "서비스 주체가 Power BI API를 사용하도록 허용"이 켜짐(ON) 상태여야 합니다.

• [ ] 작업 영역: 앱 또는 사용자가 멤버/기여자로 추가되어야 합니다.

🤝 크레딧

이 브리지는 Microsoft Power BI 모델링 MCP 서버를 핵심 엔진으로 사용합니다. 프로토콜 구현을 제공한 Microsoft 팀에 특별한 감사를 드립니다.

📄 라이선스

MIT 라이선스. 자유롭게 사용하고 기여해 주세요!