Follow Plan

Seguimiento y gestión de planes de implementación de IA.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP Follow Plan

Un servidor integral de Protocolo de Contexto de Modelo (MCP) para planificación inteligente de proyectos y gestión de tareas con persistencia SQLite y capacidades de búsqueda de texto completo.

Características

  • Gestión de Tareas: Crear, actualizar y rastrear tareas con estado, prioridad y progreso
  • Planificación de Funcionalidades: Gestionar historias de usuario, épicas y especificaciones de funcionalidades
  • Seguimiento de Errores: Reportar y rastrear errores con niveles de severidad y pasos de reproducción
  • Motor de Reglas: Definir reglas de proyecto, validaciones y pautas de automatización
  • Búsqueda de Texto Completo: Búsqueda avanzada en todos los elementos del plan con puntuación de relevancia
  • Almacenamiento SQLite: Almacenamiento persistente con indexación de búsqueda de texto completo FTS5
  • Sincronización Automática: Sincronización automática entre base de datos y sistema de archivos
  • Respaldo/Restauración: Funcionalidad de respaldo y restauración de base de datos

Inicio Rápido

1. Instalar Dependencias

npm install

2. Compilar el Proyecto

npm run build

3. Iniciar el Servidor MCP

npm start /path/to/your/project

El servidor creará un directorio .plan en tu proyecto con la siguiente estructura:

.plan/
├── database.db          # SQLite database
├── index.md            # Project overview
├── tasks/              # Task files
├── features/           # Feature files
├── bugs/               # Bug files
├── rules/              # Rule files
├── workflows/          # Workflow documentation
├── changelog/          # Project changelog
└── tmp/                # Temporary files and logs

Herramientas MCP

Gestión de Tareas

  • create_task - Crear una nueva tarea
  • update_task - Actualizar una tarea existente
  • get_task - Obtener detalles de tarea por ID
  • list_tasks - Listar tareas con filtros opcionales
  • delete_task - Eliminar una tarea

Gestión de Funcionalidades

  • create_feature - Crear una nueva funcionalidad
  • update_feature - Actualizar una funcionalidad existente
  • get_feature - Obtener detalles de funcionalidad por ID
  • list_features - Listar funcionalidades con filtros opcionales
  • delete_feature - Eliminar una funcionalidad

Seguimiento de Errores

  • create_bug - Crear un nuevo reporte de error
  • update_bug - Actualizar un error existente
  • get_bug - Obtener detalles de error por ID
  • list_bugs - Listar errores con filtros opcionales
  • delete_bug - Eliminar un error

Gestión de Reglas

  • create_rule - Crear una nueva regla de proyecto
  • update_rule - Actualizar una regla existente
  • get_rule - Obtener detalles de regla por ID
  • list_rules - Listar reglas con filtros opcionales
  • delete_rule - Eliminar una regla

Búsqueda y Descubrimiento

  • search - Buscar en todos los elementos del plan
  • advanced_search - Búsqueda avanzada con filtros

Gestión de Datos

  • backup_database - Crear un respaldo de base de datos
  • restore_database - Restaurar desde respaldo
  • sync_filesystem - Sincronizar base de datos al sistema de archivos

Recursos MCP

  • plan://index - Resumen del plan del proyecto (Markdown)
  • plan://tasks - Todas las tareas (JSON)
  • plan://features - Todas las funcionalidades (JSON)
  • plan://bugs - Todos los errores (JSON)
  • plan://rules - Todas las reglas (JSON)
  • plan://stats - Estadísticas del proyecto (JSON)

Configuración

Claude Desktop

Agrega a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "follow-plan": {
      "command": "node",
      "args": [
        "/path/to/follow-plan-mcp/dist/index.js",
        "/path/to/your/project"
      ],
      "env": {}
    }
  }
}

Variables de Entorno

  • LOG_LEVEL - Establecer nivel de registro (debug, info, warn, error)
  • PLAN_AUTO_SYNC - Habilitar/deshabilitar sincronización automática (predeterminado: true)
  • PLAN_BACKUP_INTERVAL - Intervalo de respaldo en segundos (predeterminado: 1800)

Desarrollo

Compilar

npm run build

Probar

npm test
npm run test:coverage

Lint

npm run lint
npm run lint:fix

Formatear

npm run format

Esquema de Base de Datos

El servidor usa SQLite con búsqueda de texto completo FTS5. Tablas clave:

  • tasks - Tareas del proyecto
  • features - Especificaciones de funcionalidades
  • bugs - Reportes de errores
  • rules - Reglas del proyecto
  • messages - Registros de comunicación
  • prompts - Plantillas de prompts de IA
  • cascades - Flujos de trabajo de automatización
  • fts_search - Índice de búsqueda de texto completo

Arquitectura

src/
├── index.ts              # Main MCP server
├── types/                # TypeScript type definitions
├── services/             # Business logic services
│   ├── database-service.ts
│   ├── task-service.ts
│   ├── feature-service.ts
│   ├── bug-service.ts
│   ├── rule-service.ts
│   ├── search-service.ts
│   └── persistence-service.ts
├── handlers/             # MCP request handlers
│   ├── tools.ts
│   ├── resources.ts
│   ├── validation.ts
│   └── search-handlers.ts
├── utils/                # Utility functions
└── constants/            # Application constants

Contribuciones

  1. Haz un fork del repositorio
  2. Crea una rama de funcionalidad
  3. Realiza tus cambios
  4. Agrega pruebas
  5. Ejecuta el conjunto de pruebas
  6. Envía una solicitud de extracción

Licencia

Licencia MIT - consulta el archivo LICENSE para más detalles

Soporte

Para problemas y preguntas:

  • Problemas de GitHub: [Reportar un error o solicitar una funcionalidad]
  • Documentación: Consulta el directorio /docs
  • Ejemplos: Consulta el directorio /examples

Follow Plan MCP - Planificación inteligente de proyectos para la era de la IA 🚀