Vibe-Coder

Servidor MCP Vibe-Coder

Um servidor Model Context Protocol que implementa um fluxo de trabalho de desenvolvimento estruturado para codificação baseada em LLM.

Visão Geral

Este servidor MCP ajuda LLMs a construir funcionalidades de forma organizada, limpa e segura, fornecendo:

• Um processo estruturado de clarificação de funcionalidades com perguntas guiadas
• Geração de PRD e plano de implementação
• Desenvolvimento em fases com acompanhamento de tarefas
• Acompanhamento de progresso e relatórios de status
• Capacidades de armazenamento e recuperação de documentos

Funcionalidades

Recursos

• Detalhes de funcionalidades, PRDs e planos de implementação
• Relatórios de progresso e acompanhamento de status
• Detalhes de fases e tarefas

Ferramentas

• start_feature_clarification - Iniciar o processo de clarificação de funcionalidades
• provide_clarification - Responder perguntas de clarificação sobre uma funcionalidade
• generate_prd - Gerar um Documento de Requisitos do Produto e plano de implementação
• create_phase - Criar uma fase de desenvolvimento para uma funcionalidade
• add_task - Adicionar tarefas a uma fase de desenvolvimento
• update_phase_status - Atualizar o status de uma fase
• update_task_status - Atualizar o status de conclusão de uma tarefa
• get_next_phase_action - Obter orientação sobre o que fazer a seguir
• get_document_path - Obter o caminho de um documento gerado
• save_document - Salvar um documento em um local específico

Prompts

• feature-planning - Um modelo de prompt para planejamento de desenvolvimento de funcionalidades

Armazenamento de Documentos

O servidor inclui um sistema híbrido de armazenamento de documentos que:

1. Salva automaticamente documentos gerados (PRDs, planos de implementação) em arquivos
2. Mantém uma cópia em memória para acesso rápido
3. Permite que clientes recuperem caminhos de documentos e salvem em locais personalizados

Local de Armazenamento Padrão

Os documentos são armazenados no diretório documents/{featureId}/ por padrão, com nomes de arquivo baseados no tipo de documento:

• documents/{featureId}/prd.md - Documento de Requisitos do Produto
• documents/{featureId}/implementation-plan.md - Plano de Implementação

Armazenamento Personalizado

Você pode usar a ferramenta save_document para salvar documentos em locais personalizados:

{
  "featureId": "feature-123",
  "documentType": "prd",
  "filePath": "/custom/path/feature-123-prd.md"
}

Recuperação de Caminho

Para obter o caminho de um documento, use a ferramenta get_document_path:

{
  "featureId": "feature-123",
  "documentType": "prd"
}

Isso retorna tanto o caminho quanto se o documento foi salvo em disco.

Desenvolvimento

Instalar dependências:

npm install

Compilar o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Instalação

Para usar com clientes MCP compatíveis:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vibe-coder-mcp": {
      "command": "/path/to/vibe-coder-mcp/build/mcp-server.js"
    }
  }
}

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o Inspetor MCP, que está disponível como um script de pacote:

npm run inspector

O Inspetor fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.

Notas de Implementação

Este servidor é implementado usando a classe de alto nível McpServer do SDK TypeScript do Model Context Protocol, que simplifica o processo de criação de servidores MCP fornecendo uma API limpa para definir recursos, ferramentas e prompts.

import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

// Create an MCP server
const server = new McpServer({
  name: "Vibe-Coder",
  version: "0.3.0"
});

// Add a resource
server.resource(
  "features-list",
  "features://list",
  async (uri) => ({ /* ... */ })
);

// Add a tool
server.tool(
  "start_feature_clarification",
  { /* parameters schema */ },
  async (params) => ({ /* ... */ })
);

// Add a prompt
server.prompt(
  "feature-planning",
  { /* parameters schema */ },
  (params) => ({ /* ... */ })
);

// Start the server
const transport = new StdioServerTransport();
await server.connect(transport);

Fluxo de Trabalho

O servidor MCP Vibe-Coder é projetado para guiar o processo de desenvolvimento através das seguintes etapas:

1. Clarificação de Funcionalidades: Comece coletando requisitos e entendendo o propósito da funcionalidade, usuários-alvo e restrições
2. Documentação: Gere um PRD e plano de implementação com base nos requisitos clarificados
3. Desenvolvimento em Fases: Divida a implementação em fases lógicas com tarefas claras
4. Acompanhamento de Progresso: Monitore a conclusão de tarefas e fases para guiar o desenvolvimento
5. Conclusão: Verifique se todos os requisitos foram implementados e a funcionalidade está pronta para uso