Superpower MCP

Permite la ejecución de superpoderes mediante MCP

Documentación

superpowers-mcp

Un servidor MCP que hace que las habilidades de superpowers estén disponibles para cualquier LLM que admita el Model Context Protocol.

Superpowers es una biblioteca de habilidades para Claude Code que impone flujos de trabajo disciplinados: TDD, depuración sistemática, brainstorming, planificación y más. Este servidor expone esas habilidades a cualquier cliente compatible con MCP: Cursor, Windsurf, Gemini, Kilo Code, Claude Desktop o tu propia aplicación.

Inicio Rápido

1. Clona y compila

git clone https://github.com/erophames/superpowers-mcp.git
cd superpowers-mcp
npm install
npm run build

2. Ejecuta la configuración

node build/index.js

En la primera ejecución en una terminal, el asistente de configuración clona el repositorio de superpowers y guarda la configuración.

3. Configura tu cliente MCP

Añade a la configuración del servidor MCP de tu cliente:

{
  "mcpServers": {
    "superpowers": {
      "command": "node",
      "args": ["/absolute/path/to/superpowers-mcp/build/index.js"]
    }
  }
}

Reemplaza /absolute/path/to/ con la ruta real donde clonaste el repositorio.

Ubicaciones de archivos de configuración específicos del cliente

Cliente	Ubicación de configuración
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Code	`~/.claude.json` o proyecto `.mcp.json`
Cursor	Cursor Settings > MCP
Windsurf	`~/.codeium/windsurf/mcp_config.json`

Qué Expone

El servidor registra habilidades a través de las tres primitivas de MCP:

Herramientas

Herramienta	Descripción
`list_skills`	Lista todas las habilidades disponibles con descripciones y listas de archivos
`use_skill`	Carga una habilidad por nombre: devuelve el contenido completo de la habilidad como instrucciones a seguir (aplicación opcional de salvaguardas)
`get_skill_file`	Carga un archivo de soporte de una habilidad (documentos de referencia, plantillas de prompts, scripts)
`recommend_skills`	Recomienda las mejores habilidades para una tarea mediante clasificación semántica + refuerzos de políticas de flujo de trabajo
`compose_workflow`	Construye un flujo de trabajo ordenado de múltiples habilidades para un objetivo
`validate_workflow`	Valida las habilidades seleccionadas contra las salvaguardas requeridas del flujo de trabajo
`semantic_search_skills`	Búsqueda semántica en `SKILL.md` y archivos de soporte

Prompts

Cada habilidad se registra como un prompt de MCP llamado superpowers:{skill-name}. Los clientes que admiten la selección de prompts mostrarán estos en su interfaz. Seleccionar un prompt inyecta el contenido completo de la habilidad en la conversación.

Recursos

El SKILL.md de cada habilidad y sus archivos de soporte se registran como recursos:

superpowers://skills/brainstorming/SKILL.md
superpowers://skills/test-driven-development/testing-anti-patterns.md
superpowers://skills/systematic-debugging/root-cause-tracing.md

Una plantilla de recursos superpowers://skills/{skillName}/{fileName} permite el acceso dinámico a cualquier archivo.

Habilidades Disponibles

Habilidad	Qué hace
`brainstorming`	Diseño colaborativo mediante preguntas, enfoques y validación incremental
`writing-plans`	Planes de implementación en pequeñas porciones con rutas de archivo exactas y pasos de TDD
`executing-plans`	Ejecución por lotes de planes con puntos de control de revisión entre tareas
`subagent-driven-development`	Subagente nuevo por tarea con revisión de código en dos etapas
`dispatching-parallel-agents`	Distribuye tareas independientes a agentes concurrentes
`test-driven-development`	Ciclo RED-GREEN-REFACTOR: escribe primero la prueba que falla, siempre
`systematic-debugging`	Análisis de causa raíz en 4 fases: investiga antes de corregir
`verification-before-completion`	Ejecuta el comando, lee la salida y luego reclama el resultado
`requesting-code-review`	Despacha la revisión de código y actúa sobre los comentarios categorizados por severidad
`receiving-code-review`	Rigor técnico al recibir comentarios: verifica, no estés de acuerdo a ciegas
`using-git-worktrees`	Worktrees de git aislados para desarrollo paralelo de funcionalidades
`finishing-a-development-branch`	Opciones estructuradas para merge, PR o limpieza al terminar
`writing-skills`	Marco para crear, probar e implementar nuevas habilidades
`using-superpowers`	Cómo funciona el sistema de habilidades y cuándo invocar habilidades

Ejemplos de Uso

Una vez conectado, pregunta a tu asistente de IA:

"¿Qué habilidades de superpowers están disponibles?" (llama a list_skills)
"Usa la habilidad de brainstorming para ayudarme a diseñar una capa de caché."
"Carga la habilidad de TDD y síguela para implementar esta funcionalidad."
"Lee el archivo de anti-patrones de la habilidad test-driven-development."
"Recomienda las mejores habilidades para implementar esta funcionalidad de MCP."
"Compón un flujo de trabajo para depurar pruebas inestables."
"Valida este flujo de trabajo: brainstorming, writing-plans, test-driven-development."
"Busca en las habilidades técnicas de rastreo de causa raíz."

Configuración

Variables de Entorno

Variable	Descripción
`SUPERPOWERS_SKILLS_DIR`	Anula directamente la ruta del directorio de habilidades

Orden de Descubrimiento de Habilidades

Variable de entorno SUPERPOWERS_SKILLS_DIR
Directorio guardado desde el asistente de configuración (persistido en ~/.config/superpowers-mcp)
Caché de plugins de Claude Code (~/.claude/plugins/cache/claude-plugins-official/superpowers/*/skills/)

Actualizaciones Automáticas

Cuando las habilidades provienen de un repositorio git, el servidor busca actualizaciones una vez al día al iniciar y descarga automáticamente los nuevos cambios.

Desarrollo

npm install
npm run build
npm test

Script	Descripción
`npm run build`	Compila TypeScript
`npm run dev`	Compilación en modo watch
`npm test`	Ejecuta las 58 pruebas
`npm run test:watch`	Pruebas en modo watch
`npm start`	Ejecuta el servidor

Arquitectura

src/
  index.ts                  Entry point, stdio transport, setup and update orchestration
  server.ts                 McpServer creation, composes all registrations
  config.ts                 Persistent configuration
  update.ts                 Daily auto-update check
  git.ts                    Git operations (clone, pull, fetch) via execFile
  cli/setup.ts              Interactive setup wizard
  skills/
    types.ts                Skill, SkillFile, SkillMetadata interfaces
    discovery.ts            Directory scanning, YAML frontmatter parsing, version resolution
  tools/register.ts         list_skills, use_skill, get_skill_file
  prompts/register.ts       One MCP prompt per skill
  resources/register.ts     Static resources per file + resource template for dynamic access

Pruebas

Licencia

MIT