Power BI Unified MCP

Una interfaz MCP unificada para la ingeniería de modelos semánticos de Power BI impulsada por IA y la creación de informes PBIR/PBIP.

Las operaciones de modelos semánticos se ejecutan a través del MCP de Modelado de Power BI de Microsoft. Este proyecto añade orquestación unificada, creación local de informes PBIR/PBIP, controles de seguridad, diagnósticos y transportes stdio/HTTP detrás de un único servidor MCP.

Estado: Early Release / Public Preview - v0.2.0

Power BI es un producto de Microsoft. Este repositorio no es propiedad de Microsoft, no incluye el ejecutable de modelado de Microsoft y no es un sustituto completo de Power BI Desktop.

Por Qué Existe

La automatización de Power BI abarca actualmente dos capas diferentes:

• ingeniería de modelos semánticos contra Power BI Desktop o modelos tabulares compatibles

• edición de definiciones de informes PBIR/PBIP en disco

Este proyecto une ambas capas para que un cliente de IA pueda inspeccionar, validar y modificar informes y modelos a través de un catálogo de herramientas MCP unificado, respetando al mismo tiempo los controles de seguridad locales.

Related MCP server: powerbi-mcp-local

En Qué Se Diferencia Del MCP de Modelado de Microsoft

El MCP de Modelado de Microsoft se centra en operaciones de modelos semánticos como conexiones, tablas, columnas, medidas, relaciones, DAX, roles, particiones, TMDL y trabajo relacionado con metadatos.

powerbi-unified-mcp conserva esa capacidad ascendente, pero añade:

• descubrimiento y ciclo de vida de proyectos de informes PBIR/PBIP locales

• creación de páginas y objetos visuales

• vinculación de campos y formato

• temas, filtros, interacciones, validación, puntos de control y deshacer

• una superficie MCP unificada para el trabajo con informes y modelos

• aplicación de políticas locales, diagnósticos, registro de auditoría e informes de capacidades

Alcance Actual

Lo que v0.2.0 puede hacer hoy:

• descubrir y abrir proyectos de informes PBIR/PBIP

• crear, renombrar, duplicar y eliminar páginas de informes

• crear, inspeccionar, mover, redimensionar, cambiar de tipo, vincular y formatear objetos visuales compatibles

• aplicar temas, configurar filtros, configurar interacciones visuales y validar la estructura del informe

• crear puntos de control de informes, restaurar puntos de control y deshacer cambios recientes en informes

• actuar como proxy de operaciones de modelos semánticos desde el MCP de Modelado de Microsoft

• soportar el descubrimiento local de Power BI Desktop, conexión, validación/ejecución de DAX y CRUD temporal de medidas a través de la familia de herramientas ascendente

• exponer transportes stdio y HTTP utilizando el SDK oficial de MCP

Lo que aún no hace:

• mutación directa del lienzo .pbix en vivo sin un proyecto PBIR/PBIP

• gestión completa del ciclo de vida de Power BI Service o Fabric

• mutación de marcadores o creación completa de botones/navegación

• una abstracción completa de formato condicional

• soporte para todos los objetos visuales nativos o personalizados de Power BI

• despliegue multiusuario alojado, autenticación o RBAC como producto finalizado

Arquitectura

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]

División en lenguaje sencillo:

• La creación de informes está implementada en este repositorio y funciona con proyectos PBIR/PBIP en disco.

• La ingeniería de modelos semánticos se delega al MCP de Modelado externo de Microsoft y luego se envuelve con comprobaciones de compatibilidad, aplicación de políticas, diagnósticos y registro de auditoría.

Más detalle: Arquitectura

Instalación Rápida

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

Si el MCP de Modelado de Microsoft no se detecta automáticamente:

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

Ejecutar en modo stdio:

node server.js

Ejecutar en modo HTTP:

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

Comprobación de estado:

curl http://127.0.0.1:8765/health

Configuración completa: Instalación

Ejemplos de Clientes MCP

• Clientes MCP Genéricos

• Codex

• Claude

• ChatGPT

Ejemplos de Prompts

Inspecciona mi modelo de Power BI Desktop actualmente abierto y resume las tablas, medidas y relaciones.

Crea una medida de Beneficio Total, valida el DAX y consúltala para confirmar que funciona.

Abre este proyecto de informe PBIR y lista las páginas del informe, los objetos visuales y el tema activo.

Crea una página de informe de Resumen Ejecutivo con tarjetas de Ventas Totales y Beneficio, tendencia mensual de ventas, gráfico de barras de ventas por categoría y un segmentador de Región.

Encuentra el objeto visual Ventas por Categoría, cámbialo a un gráfico de barras agrupadas, muévelo al lado derecho de la página y valida el informe.

Valida el informe PBIR actual y explica cualquier error antes de modificar nada.

Seguridad

Modos de seguridad:

• read-only

• safe-write

• full

Valores predeterminados importantes:

• las mutaciones de informes están restringidas a raíces de sistema de archivos configuradas

• la mayoría de las escrituras de informes crean puntos de control automáticos por defecto

• las operaciones de modelado destructivas o sensibles a la seguridad están sujetas a políticas

• el modo HTTP es un transporte de desarrollo y debe tratarse como local-first

No expongas un endpoint en modo full públicamente sin autenticación, TLS, proxy inverso, registro y protecciones de red.

Más detalle: Modelo de Seguridad

Compatibilidad

• Node.js >=20

• Windows es el entorno principal compatible para la integración en vivo con Power BI Desktop

• las funciones de modelos semánticos requieren el MCP de Modelado de Power BI de Microsoft

• versión mínima compatible del MCP de Modelado ascendente: 0.4.0

• v0.2.0 se ha probado en vivo contra un modelo real de Power BI Desktop para descubrimiento, conexión, inspección de metadatos, validación/ejecución de DAX y CRUD temporal de medidas con limpieza

Más detalle: Compatibilidad con el MCP de Modelado

Limitaciones

• las ediciones directas del lienzo .pbix no son la vía de creación de informes; utiliza proyectos PBIR/PBIP

• las funciones de modelos semánticos dependen del ejecutable ascendente de Microsoft

• la integración en vivo con Desktop está centrada en Windows

• la cobertura de objetos visuales de informes es sustancial pero no completa

Más detalle: Limitaciones

Documentación

• Inicio de Documentación

• Inicio Rápido

• Power BI Desktop

• Modelado Semántico

• Creación de Informes

• Catálogo de Objetos Visuales

• Referencia de Configuración

• Referencia de Herramientas

• Matriz de Capacidades Generada

• Solución de Problemas

• Hoja de Ruta

Contribuciones

Configuración del colaborador, flujo de pruebas, generación de metadatos y expectativas de publicación: CONTRIBUTING.md

Licencia

MIT. Ver LICENSE.