Servidor MCP de Vibe-Coder

Un servidor de protocolo de contexto de modelo que implementa un flujo de trabajo de desarrollo estructurado para la codificación basada en LLM.

Descripción general

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

Un proceso estructurado de aclaración de características con preguntas guiadas
Generación del plan de implementación y del PRD
Desarrollo por fases con seguimiento de tareas
Seguimiento del progreso e informes de estado
Capacidades de almacenamiento y recuperación de documentos

Características

Recursos

Detalles de funciones, PRD y planes de implementación
Informes de progreso y seguimiento del estado
Detalles de fases y tareas

Herramientas

start_feature_clarification - Iniciar el proceso de aclaración de funciones
provide_clarification - Responder preguntas de aclaración sobre una característica
generate_prd - Generar un Documento de Requisitos del Producto y un plan de implementación
create_phase - Crea una fase de desarrollo para una función
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 - Obtenga 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

Indicaciones

feature-planning : una plantilla de ayuda para planificar el desarrollo de funciones

Almacenamiento de documentos

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

Guarda automáticamente los documentos generados (PRD, planes de implementación) en archivos
Mantiene una copia en memoria para un acceso rápido
Permite a los clientes recuperar rutas de documentos y guardarlos 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 del producto
documents/{featureId}/implementation-plan.md - Plan de implementación

Almacenamiento personalizado

Puede utilizar 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 ruta

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

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

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

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para utilizar 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 complicada. Recomendamos usar el Inspector MCP , disponible como 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 se implementa utilizando la clase McpServer de alto nivel del Model Context Protocol TypeScript SDK, que simplifica el proceso de creación de servidores MCP al proporcionar una API limpia para definir recursos, herramientas y avisos.

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 Vibe-Coder MCP está diseñado para guiar el proceso de desarrollo a través de los siguientes pasos:

Aclaración de funciones : comience por reunir los requisitos y comprender el propósito de la función, los usuarios objetivo y las limitaciones.
Documentación : Generar un PRD y un plan de implementación basado en los requisitos aclarados
Desarrollo por fases : Divida la implementación en fases lógicas con tareas claras
Seguimiento del progreso : supervisar la finalización de tareas y fases para guiar el desarrollo.
Finalización : verificar que se hayan implementado todos los requisitos y que la función esté lista para usarse

Vibe-Coder MCP Server

Integrations