Claude Prompts MCP Server

Claude Prompts

A camada de fluxo de trabalho portátil ao lado do seu harness de codificação de IA.

Seu cliente executa com suas próprias ferramentas, agentes e contexto.
Claude Prompts adiciona recursos de prompt reutilizáveis, cadeias componíveis, portões de validação e exportação de habilidades nativas do cliente.

Quick Start · What You Get · Compose Workflows · Run Anywhere · Docs

O que seu cliente de IA oferece — e o que este servidor adiciona

Isso é para mim?

• Use isto se você escreve os mesmos prompts repetidamente, executa fluxos de trabalho em várias etapas ou deseja compartilhar prompts reutilizáveis com uma equipe.
• Pule se os /commands integrados do seu cliente já atendem ao que você precisa, ou se você procura uma biblioteca de prompts sem código.
• Funciona com Claude Code, Claude Desktop, Cursor, OpenCode, Gemini CLI, Codex, Windsurf e Zed. Os instaladores de plugins adicionam hooks (rastreamento de cadeia, aplicação de portões, preservação de estado) para Claude Code, OpenCode, Gemini CLI e Codex (experimental); outros clientes executam apenas via MCP.

Quick Start

Claude Code (Recomendado)

# Add marketplace (first time only)
/plugin marketplace add minipuft/minipuft-plugins

# Install
/plugin install claude-prompts@minipuft

# Try it
>>tech_evaluation_chain library:'zod' context:'API validation'

git clone https://github.com/minipuft/claude-prompts-mcp ~/Applications/claude-prompts-mcp
cd ~/Applications/claude-prompts-mcp/server && npm install && npm run build
claude --plugin-dir ~/Applications/claude-prompts-mcp

Codex (Experimental)

Os hooks do Codex exigem Codex CLI 0.117 ou posterior e não estão disponíveis no Windows. Consulte os requisitos do codex-prompts para pré-requisitos de Python e Node.js.

Ative os hooks em ~/.codex/config.toml:

[features]
hooks = true

Em seguida, instale o plugin:

codex plugin marketplace add https://github.com/minipuft/minipuft-plugins.git
codex plugin add codex-prompts@minipuft

Reinicie o Codex, execute /hooks para revisar os hooks do plugin e depois tente >>tech_evaluation_chain library:'zod' context:'API validation'.

Mais Configurações de Cliente

Claude Desktop

Opção A: GitHub Release (recomendado)

1. Baixe claude-prompts-{version}.mcpb de Releases
2. Arraste para Claude Desktop Settings → MCP Servers
3. Pronto

O pacote .mcpb é autossuficiente (~5MB); não requer npm.

Opção B: NPX (atualizações automáticas)

Adicione ao seu arquivo de configuração:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-prompts": {
      "command": "npx",
      "args": ["-y", "claude-prompts@latest", "--client", "claude-code"]
    }
  }
}

Reinicie o Claude Desktop e teste: >>research_chain topic:'remote team policies'

# OpenCode (full hooks)
npm install -g opencode-prompts && opencode-prompts install

# Gemini CLI (partial hooks)
gemini extensions install https://github.com/minipuft/gemini-prompts

git clone https://github.com/minipuft/claude-prompts-mcp.git
cd claude-prompts-mcp/server && npm install && npm run build && npm test

Recursos personalizados: --init=~/my-prompts cria um workspace inicial: três prompts de exemplo mais config.jsonc. Edite-os (esquema YAML) ou peça à sua IA para criar novos prompts, portões e frameworks via resource_manager. Aponte MCP_RESOURCES_PATH para um workspace existente se você já tiver um no formato correto. Consulte Custom Resources Guide.

O Que Você Obtém

Quatro primitivas que você cria, versiona e compõe. O conjunto incluído traz 51 prompts em 9 categorias — uma biblioteca inicial, não o limite: sua IA escreve novos prompts e cadeias através de resource_manager enquanto trabalha, então o conjunto cresce em torno do que você realmente faz. Tudo com hot-reload, tudo versionado com rollback.

Prompts, portões e frameworks são gerenciados pela ferramenta resource_manager. Sua IA cria, edita, versiona e faz rollback deles via MCP, sem necessidade de edição de arquivos. Estilos são gerenciados com o CLI cpm incluído. Verificações de portão com falha podem tentar novamente automaticamente ou pausar para sua decisão (Gates Guide). Crie sua primeira primitiva: Prompt Authoring Tutorial.

As Três Ferramentas

Tudo acima chega ao seu cliente por meio de três ferramentas MCP:

A maioria dos usuários invoca estas via sintaxe >> na conversa; os hooks constroem as chamadas reais. Para clientes MCP programáticos chamando ferramentas diretamente, consulte MCP Tools Reference.

Compor Fluxos de Trabalho

Como escrever uma cadeia

>>review target:'src/auth/' @ReACT :: 'cite sources'
  --> security_scan :: verify:"npm test"
  ==> implementation

Leia de cima para baixo:

• >>review target:'src/auth/' executa o prompt review na sua pasta de autenticação.
• @ReACT sobrepõe o framework de raciocínio ReACT nesta etapa.
• :: 'cite sources' adiciona um portão que a IA deve satisfazer (citar fontes ou tentar novamente).
• --> security_scan :: verify:"npm test" encadeia para a etapa 2, que deve passar em npm test antes de produzir a saída.
• ==> implementation entrega a etapa final a um agente nativo do cliente (um subagente no Claude Code).

review acompanha o servidor; security_scan e implementation representam prompts que você escreve.

A validação ocorre entre etapas, não apenas no final. Para a gramática completa de operadores e exemplos, consulte MCP Tools Reference.

_{Um portão detecta um campo ausente, o modelo se corrige e a cadeia passa. Gravado no haiku, o modelo mais barato.}

Dois padrões estendem a sintaxe básica. As cadeias também suportam conexão de contexto entre etapas e transferências de agentes. Consulte Chains Lifecycle e MCP Tools Reference.

Veja a saída: cadeia de avaliação técnica com pesquisa context7

_{Context7 busca documentação de bibliotecas ao vivo no meio da cadeia. A saída final é uma avaliação estruturada com fontes.}

Loops de Verificação

Validação de verdade fundamental via comandos de shell. A IA continua iterando até os testes passarem:

>>implement-feature :: verify:"npm test" loop:true

Implementa, executa o teste, lê falhas, corrige, tenta novamente. Gera um novo contexto após falhas repetidas para evitar degradação do contexto.

implement-feature representa seu próprio prompt: :: verify se anexa a qualquer um deles.

Para ciclos autônomos de teste-correção com prevenção de degradação de contexto: Ralph Loops Guide.

Modo Juiz

Deixe a IA escolher os recursos certos para a tarefa:

%judge Help me refactor this authentication module

Analisa modelos disponíveis, frameworks de raciocínio, regras de validação e estilos, e então recomenda a melhor combinação. Você confirma antes de executar. Para pontuação e substituições, consulte Judge Mode Guide.

Execute em Qualquer Lugar

Crie fluxos de trabalho como modelos YAML. Exporte como habilidades nativas para seu cliente.

[!IMPORTANT] Há dois escopos de fonte de verdade. O YAML de prompt MCP em server/resources/ é canônico para habilidades compiladas por este repositório. Habilidades operacionais compartilhadas criadas pelo usuário, regras e instruções globais são canônicas em ~/.claude; instalações do Codex e OpenCode são consumidores downstream unidirecionais e não devem ser editadas de forma independente. O Codex usa symlinks por habilidade; Codex e OpenCode compartilham um AGENTS.md global gerado contendo o CLAUDE.md global mais despacho compacto de regras. O OpenCode descobre nativamente ~/.claude/skills e carrega esse arquivo gerado através de sua configuração instructions. ~/.codex/rules/ permanece reservado para a política de execução de comandos do Codex. As orientações do repositório seguem a mesma regra de propriedade. CLAUDE.md e .claude/rules/*.md são canônicos; o AGENTS.md rastreado é uma projeção compacta gerada para clientes que preferem esse nome de arquivo. Ele carrega seções selecionadas do manual do projeto, além de entradas de despacho condicional para cada regra do Claude, em vez de copiar todos os corpos das regras para o contexto sempre carregado. O renderizador aplica o orçamento padrão documentado de 32 KiB para orientação de projeto do Codex. Um hook de pré-commit o regenera a partir dos bytes de origem preparados, e o CI rejeita divergências:

npm run guidance:sync   # regenerate AGENTS.md
npm run guidance:check  # verify the committed projection

# skills-sync.yaml — choose what to export
registrations:
  claude-code:
    user:
      - prompt:development/review
      - prompt:development/validate_work

npm run skills:export

O prompt review se torna uma skill do Claude Code /review. validate_work se torna /validate_work. Mesma fonte, experiência nativa; nenhuma chamada MCP necessária em tempo de execução.

Compila para skills do Claude Code, regras do Cursor, comandos do OpenCode e muito mais. npm run skills:diff sinaliza quando as exportações divergem da fonte. Configuração, clientes suportados e detecção de divergências: Guia de Sincronização de Skills.

Com Hooks

Sem hooks, você está chamando as três ferramentas MCP explicitamente (o LLM constrói cada chamada). Com hooks, os operadores funcionam em conversa: >>, -->, ==>, :: parecem nativos em vez de mediados, e o estado do fluxo de trabalho sobrevive entre turnos do LLM e compactação de contexto.

O que os hooks desbloqueiam:

Os hooks acompanham a instalação do plugin. Suporte completo no Claude Code (este repositório) e OpenCode; parcial no Gemini CLI; experimental no Codex, onde os hooks do Codex estão desativados por padrão e cada instalação exige uma revisão de confiança /hooks única. Outros clientes recebem as três ferramentas MCP, mas sem comportamentos orientados por hooks. Detalhes: hooks/README.md.

Como Funciona

Comando com operadores → o servidor analisa e injeta recursos (framework, portões, estilo) → o cliente executa o prompt renderizado e se autoavalia em relação aos portões → o roteador decide: próxima etapa em caso de aprovação, tentativa novamente em caso de falha, retorno em caso de conclusão.

Ciclo de vida completo da solicitação, estágios do pipeline e diagramas de subsistemas: Visão Geral da Arquitetura.

Documentação

Escolha um guia com base no que você deseja fazer: aprender construindo, concluir uma tarefa, consultar sintaxe ou entender o design.

→ docs/README.md

Acessos rápidos: Construa seu primeiro prompt · Ciclo de vida das cadeias · Referência das ferramentas MCP · Visão geral da arquitetura · Solução de problemas

Contribuindo

cd server
npm install
npm run build        # esbuild bundles to dist/index.js
npm test             # Run test suite
npm run validate:all # Full CI validation

A compilação produz um pacote autocontido. server/dist/ é ignorado pelo git, e o CI compila do zero a partir da fonte.

Consulte CONTRIBUTING.md para detalhes do fluxo de trabalho.

Licença

MIT