Puente SSE para MCP de Modelado de Power BI

Este proyecto es un puente SSE (Server-Sent Events) de alto rendimiento para el Servidor MCP oficial de modelado de Power BI de Microsoft. Permite una interacción fluida basada en URL con modelos semánticos de Power BI desde cualquier lenguaje (Laravel, Python, Go) sin necesidad de tuberías stdio locales.

🔥 Innovaciones clave

• Auto-Auth (Inyección de tokens): Realiza automáticamente un flujo ROPC de Azure utilizando sus credenciales de administrador para inyectar un token de acceso. Resultado: Cero ventanas emergentes del navegador en su servidor.

• Resolución binaria dinámica: Detecta automáticamente su sistema operativo y arquitectura de CPU para ejecutar el binario MCP de Microsoft correcto.

• Inyección de contexto de Laravel: Pase los ID de área de trabajo y conjunto de datos a través de parámetros de consulta URL para mantener contextos específicos de la sesión.

• Listo para la web: Perfecto para crear interfaces de chat de IA personalizadas para Power BI.

Related MCP server: powerbi-mcp-proxy

🛠️ Instalación y inicio rápido

1. Requisitos

• Node.js v18 o superior.

• Cuenta de administrador de Power BI (usuario maestro) o entidad de servicio.

2. Configuración

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

3. Configuración

Cree un archivo .env a partir de la plantilla:

cp .env.example .env

Complete sus credenciales MS_PBI_.... Importante: Para que el inicio de sesión basado en contraseña funcione sin un navegador, habilite "Permitir flujos de cliente público" en su Registro de aplicaciones de Azure -> Configuración de autenticación.

4. Ejecución

npm start

El puente estará activo en http://localhost:3000/sse.

🔗 Ejemplo de integración con Laravel

Usando la fachada Http de Laravel para interactuar con el puente:

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();

🛡️ Lista de verificación de permisos de Power BI

• [ ] Azure Portal: El registro de la aplicación existe con Tenant.Read.All.

• [ ] Administrador de Power BI: "Permitir que las entidades de servicio usen las API de Power BI" está ACTIVADO.

• [ ] Área de trabajo: La aplicación o el usuario se agrega como Miembro/Colaborador.

🤝 Créditos

Este puente utiliza el Servidor MCP de modelado de Power BI de Microsoft como motor principal. Un agradecimiento especial al equipo de Microsoft por la implementación del protocolo.

📄 Licencia

Licencia MIT. ¡Siéntase libre de usar y contribuir!