Vibe-Coder

Un flujo de trabajo de desarrollo estructurado para la codificación basada en LLM, que incluye clarificación de características, planificación, desarrollo por fases y seguimiento del progreso.

GitHub
18
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Vibe-Coder

Un servidor de Protocolo de Modelo de Contexto que implementa un flujo de trabajo de desarrollo estructurado para codificación basada en LLM.

Descripción general

Este servidor MCP ayuda a los LLM a construir funcionalidades de manera organizada, limpia y segura al proporcionar:

  • Un proceso estructurado de clarificación de funcionalidades con preguntas guiadas
  • Generación de PRD y planes de implementación
  • Desarrollo por fases con seguimiento de tareas
  • Seguimiento de progreso e informes de estado
  • Capacidades de almacenamiento y recuperación de documentos

Funcionalidades

Recursos

  • Detalles de funcionalidades, PRDs y planes de implementación
  • Informes de progreso y seguimiento de estado
  • Detalles de fases y tareas

Herramientas

  • start_feature_clarification - Iniciar el proceso de clarificación de funcionalidades
  • provide_clarification - Responder preguntas de clarificación sobre una funcionalidad
  • generate_prd - Generar un Documento de Requisitos de Producto y un plan de implementación
  • create_phase - Crear una fase de desarrollo para una funcionalidad
  • add_task - Agregar tareas a una fase de desarrollo
  • update_phase_status - Actualizar el estado de una fase
  • update_task_status - Actualizar el estado de finalización de una tarea
  • get_next_phase_action - Obtener orientación sobre qué hacer a continuación
  • get_document_path - Obtener la ruta de un documento generado
  • save_document - Guardar un documento en una ubicación específica

Prompts

  • feature-planning - Una plantilla de prompt para planificar el desarrollo de funcionalidades

Almacenamiento de documentos

El servidor incluye un sistema híbrido de almacenamiento de documentos que:

  1. Guarda automáticamente los documentos generados (PRDs, planes de implementación) en archivos
  2. Mantiene una copia en memoria para acceso rápido
  3. Permite a los clientes recuperar rutas de documentos y guardar en ubicaciones personalizadas

Ubicación de almacenamiento predeterminada

Los documentos se almacenan en el directorio documents/{featureId}/ de forma predeterminada, con nombres de archivo basados en el tipo de documento:

  • documents/{featureId}/prd.md - Documento de Requisitos de Producto
  • documents/{featureId}/implementation-plan.md - Plan de Implementación

Almacenamiento personalizado

Puede usar la herramienta save_document para guardar documentos en ubicaciones personalizadas:

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

Recuperación de rutas

Para obtener la ruta de un documento, use la herramienta get_document_path:

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

Esto devuelve tanto la ruta como si el documento se ha guardado en disco.

Desarrollo

Instalar dependencias:

npm install

Compilar el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para usar con clientes MCP compatibles:

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

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

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el Inspector MCP, que está disponible como un script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Notas de implementación

Este servidor está implementado usando la clase de alto nivel McpServer del SDK de TypeScript del Protocolo de Modelo de Contexto, que simplifica el proceso de creación de servidores MCP al proporcionar una API limpia para definir recursos, herramientas y 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);

Flujo de trabajo

El servidor MCP de Vibe-Coder está diseñado para guiar el proceso de desarrollo a través de los siguientes pasos:

  1. Clarificación de funcionalidades: Comience recopilando requisitos y comprendiendo el propósito de la funcionalidad, los usuarios objetivo y las restricciones
  2. Documentación: Genere un PRD y un plan de implementación basados en los requisitos aclarados
  3. Desarrollo por fases: Divida la implementación en fases lógicas con tareas claras
  4. Seguimiento de progreso: Monitoree la finalización de tareas y fases para guiar el desarrollo
  5. Finalización: Verifique que todos los requisitos se hayan implementado y que la funcionalidad esté lista para su uso