BI Agent Superpowers

Toolkit open-source para trabajar con Power BI Desktop desde tu agente AI favorito. Funciona con los 5 agentes soportados: Claude Code, GitHub Copilot, Codex, Gemini CLI y Kilo Code.

Estado: versión inicial. 2 skills y 2 MCP servers para empezar a iterar.

Quick Start

# 1. Instalá la CLI
npm install -g @luquimbo/bi-superpowers

# 2. Instalá skills y MCPs en todos tus agentes
super install

Eso es todo. El instalador:

1. Detecta qué agentes AI tenés instalados (Claude Code, Copilot, Codex, Gemini, Kilo).
2. Te deja elegir para cuáles instalar (o hace todos con --all --yes).
3. Copia los 2 skills en los directorios correctos de cada agente.
4. Escribe los 2 MCPs en el config file correcto de cada agente (con el formato/schema que cada uno espera).

Reiniciá tu agente AI, y ya tenés bi-superpowers funcionando.

Qué viene incluido

2 Skills

| Skill | Para qué | |---|---| | project-kickoff | Analizá el estado de tu proyecto BI y decidí próximos pasos | | pbi-connect | Conectá tu agente AI a Power BI Desktop vía MCP |

2 MCP Servers (oficiales de Microsoft)

| MCP | Para qué | |---|---| | powerbi-modeling | Conexión local a Power BI Desktop (XMLA). Leer/escribir modelo semántico, ejecutar DAX. | | microsoft-learn | HTTP MCP de Microsoft Learn — docs oficiales de Power BI/DAX/Fabric en contexto de la conversación. |

Agentes soportados

| Agente | Skills | MCP config path | |---|---|---| | Claude Code | ✅ ~/.claude/skills/ | ~/.claude.json | | GitHub Copilot | ✅ ~/.copilot/skills/ | ~/.copilot/mcp-config.json | | Codex (OpenAI) | ✅ ~/.agents/skills/ | ~/.codex/config.toml | | Gemini CLI | ✅ ~/.gemini/skills/ | ~/.gemini/settings.json | | Kilo Code | ✅ ~/.kilo/skills/ | ~/.kilo/mcp_settings.json |

super install escribe todo esto automáticamente.

Instalación selectiva

# Solo para Claude Code
super install --agent claude-code --yes

# Solo para Claude Code y GitHub Copilot
super install --agent claude-code --agent github-copilot --yes

# Todos sin prompts
super install --all --yes

Actualizar

# Actualizar la CLI a la última versión
npm install -g @luquimbo/bi-superpowers@latest

# Re-instalar skills y MCPs (sobrescribe los viejos)
super install --all --yes

Alternativas para instalar los MCPs

super install escribe automáticamente los 2 MCPs en el config file de cada agente. Pero hay otras formas de instalar los mismos MCPs — cualquiera de estas funciona igual de bien:

Para Power BI Modeling MCP (local)

• Extensión de VS Code — Microsoft publica "Power BI Modeling MCP" en el VS Code Marketplace. Si la instalás, VS Code + Copilot lo descubren automáticamente sin tocar archivos de config.
• Extensión de Cursor — misma extensión, Cursor la detecta.
• Manual — descargá el binario .exe y configurá BI_SUPERPOWERS_POWERBI_MODELING_MCP_PATH apuntando al ejecutable.

Para Microsoft Learn MCP (HTTP)

• MCP marketplace oficial de Anthropic — en Claude Code se puede hacer /plugin marketplace add anthropic/mcp-registry y después /plugin install microsoft-learn (según disponibilidad).
• Agregarlo a mano en el config file del agente con la URL https://learn.microsoft.com/api/mcp.

Si ya instalaste los MCPs por alguno de estos caminos, no necesitás correr super install — o, si lo corrés, los configs se mergean sin conflicto (cada agente tiene merge por clave, no por overwrite).

Requisitos

• Node.js ≥ 18
• Power BI Desktop en Windows (para el MCP powerbi-modeling — el MCP microsoft-learn funciona en cualquier plataforma)
• Al menos uno de: Claude Code, GitHub Copilot, Codex, Gemini CLI, Kilo Code

Comandos

super install          # Instalá skills + MCPs en tus agentes AI
super kickoff          # Generá el plugin de Claude Code en un proyecto (avanzado)
super recharge         # Regenerá el plugin tras editar skills fuente
super powers           # Listá skills disponibles
super upgrade          # Actualizá la CLI a la última versión
super help             # Ayuda completa

Contribuir

Este proyecto está empezando. Si querés agregar skills, mejorar los existentes, o reportar bugs:

• Abrí un issue en https://github.com/luquimbo/bi-superpowers/issues
• Pull requests bienvenidas

License

MIT © Lucas Sanchez (@luquimbo)