Superpower MCP

Permite a execução de superpoderes via MCP.

Documentação

superpowers-mcp

Um servidor MCP que disponibiliza as habilidades do superpowers para qualquer LLM que suporte o Model Context Protocol.

Superpowers é uma biblioteca de habilidades para Claude Code que impõe fluxos de trabalho disciplinados -- TDD, depuração sistemática, brainstorming, planejamento e mais. Este servidor expõe essas habilidades para qualquer cliente compatível com MCP: Cursor, Windsurf, Gemini, Kilo Code, Claude Desktop ou seu próprio aplicativo.

Início Rápido

1. Clone e compile

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

2. Execute a configuração

node build/index.js

Na primeira execução em um terminal, o assistente de configuração clona o repositório superpowers e salva a configuração.

3. Configure seu cliente MCP

Adicione à configuração do servidor MCP do seu cliente:

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

Substitua /absolute/path/to/ pelo caminho real onde você clonou o repositório.

Locais dos arquivos de configuração específicos do cliente

Cliente	Local da Configuração
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Code	`~/.claude.json` ou projeto `.mcp.json`
Cursor	Cursor Settings > MCP
Windsurf	`~/.codeium/windsurf/mcp_config.json`

O Que Ele Expõe

O servidor registra habilidades através de todas as três primitivas MCP:

Ferramentas

Ferramenta	Descrição
`list_skills`	Lista todas as habilidades disponíveis com descrições e listas de arquivos
`use_skill`	Carrega uma habilidade pelo nome -- retorna o conteúdo completo da habilidade como instruções a seguir (aplicação opcional de guardrails)
`get_skill_file`	Carrega um arquivo de suporte de uma habilidade (documentos de referência, modelos de prompt, scripts)
`recommend_skills`	Recomenda as melhores habilidades para uma tarefa usando classificação semântica + reforços de política de fluxo de trabalho
`compose_workflow`	Constrói um fluxo de trabalho multi-habilidade ordenado para um objetivo
`validate_workflow`	Valida as habilidades selecionadas contra os guardrails de fluxo de trabalho exigidos
`semantic_search_skills`	Pesquisa semântica em `SKILL.md` e arquivos de suporte

Prompts

Cada habilidade é registrada como um prompt MCP chamado superpowers:{skill-name}. Clientes que suportam seleção de prompt mostrarão esses na sua interface. Selecionar um prompt injeta o conteúdo completo da habilidade na conversa.

Recursos

O SKILL.md de cada habilidade e os arquivos de suporte são registrados como recursos:

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

Um modelo de recurso superpowers://skills/{skillName}/{fileName} permite acesso dinâmico a qualquer arquivo.

Habilidades Disponíveis

Habilidade	O que faz
`brainstorming`	Design colaborativo por meio de perguntas, abordagens e validação incremental
`writing-plans`	Planos de implementação em pequenas partes com caminhos de arquivo exatos e etapas de TDD
`executing-plans`	Execução em lote de planos com pontos de verificação de revisão entre tarefas
`subagent-driven-development`	Subagente novo por tarefa com revisão de código em duas etapas
`dispatching-parallel-agents`	Distribui tarefas independentes para agentes concorrentes
`test-driven-development`	Ciclo RED-GREEN-REFACTOR -- escreva o teste que falha primeiro, sempre
`systematic-debugging`	Análise de causa raiz em 4 fases: investigue antes de corrigir
`verification-before-completion`	Execute o comando, leia a saída e então reivindique o resultado
`requesting-code-review`	Despache revisão de código e aja com base em feedback categorizado por severidade
`receiving-code-review`	Rigor técnico ao receber feedback -- verifique, não concorde cegamente
`using-git-worktrees`	Worktrees git isolados para desenvolvimento paralelo de funcionalidades
`finishing-a-development-branch`	Opções estruturadas para merge, PR ou limpeza quando concluído
`writing-skills`	Estrutura para criar, testar e implantar novas habilidades
`using-superpowers`	Como o sistema de habilidades funciona e quando invocar habilidades

Exemplos de Uso

Depois de conectado, pergunte ao seu assistente de IA:

"Quais habilidades do superpowers estão disponíveis?" (chama list_skills)
"Use a habilidade de brainstorming para me ajudar a projetar uma camada de cache."
"Carregue a habilidade TDD e siga-a para implementar este recurso."
"Leia o arquivo de anti-padrões da habilidade test-driven-development."
"Recomende as melhores habilidades para implementar este recurso MCP."
"Componha um fluxo de trabalho para depurar testes instáveis."
"Valide este fluxo de trabalho: brainstorming, writing-plans, test-driven-development."
"Pesquise habilidades para técnicas de rastreamento de causa raiz."

Configuração

Variáveis de Ambiente

Variável	Descrição
`SUPERPOWERS_SKILLS_DIR`	Substitui o caminho do diretório de habilidades diretamente

Ordem de Descoberta de Habilidades

Variável de ambiente SUPERPOWERS_SKILLS_DIR
Diretório salvo pelo assistente de configuração (persistido em ~/.config/superpowers-mcp)
Cache de plugin do Claude Code (~/.claude/plugins/cache/claude-plugins-official/superpowers/*/skills/)

Atualizações Automáticas

Quando as habilidades são originadas de um repositório git, o servidor verifica atualizações uma vez por dia na inicialização e puxa novas alterações automaticamente.

Desenvolvimento

npm install
npm run build
npm test

Script	Descrição
`npm run build`	Compilar TypeScript
`npm run dev`	Compilação em modo de observação
`npm test`	Executar todos os 58 testes
`npm run test:watch`	Testes em modo de observação
`npm start`	Executar o servidor

Arquitetura

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

Testes

Licença

MIT