MCP Prompt Collector

Herramientas para registrar, analizar y mejorar los prompts de Claude Desktop con el fin de perfeccionar las habilidades de ingeniería de prompts.

GitHub
3
Prueba este MCPPatrocinado

Documentación

MCP Prompt Collector

Un servidor MCP que proporciona herramientas interactivas para registrar, analizar y mejorar tus prompts de Claude Desktop, ayudándote a desarrollar mejores habilidades de ingeniería de prompts.

Instalación

Opción 1: Paquete NPM (Recomendado)

# Install globally
npm install -g mcp-prompt-collector

# Or install locally in your project
npm install mcp-prompt-collector

Opción 2: Desde el código fuente

git clone https://github.com/daneb/improver-mcp.git
cd improver-mcp
npm install
npm run build

Configuración

  1. Configurar Claude Desktop

    Añade esto a tu ~/Library/Application Support/Claude/claude_desktop_config.json:

    Para instalación global de npm:

    {
  "mcpServers": {
    "mcp-prompt-collector": {
      "command": "mcp-prompt-collector",
      "env": {
        "HOME": "/Users/daneb"
      }
    }
  }
}

    Para instalación desde el código fuente:

    {
  "mcpServers": {
    "mcp-prompt-collector": {
      "command": "/path/to/your/node",
      "args": ["/path/to/improver-mcp/dist/index.js"],
      "env": {
        "HOME": "/Users/daneb"
      }
    }
  }
}

  2. Reinicia Claude Desktop para cargar el servidor MCP

  3. Accede al panel de control en http://localhost:3456

Qué hace

  • 🛠️ Herramientas interactivas: Proporciona 4 herramientas accesibles en Claude Desktop para el análisis de prompts
  • 📊 Análisis de calidad: Evalúa prompts en estructura, claridad, contexto y efectividad
  • 💡 Información inteligente: Identifica patrones y sugiere mejoras específicas
  • 📈 Seguimiento de progreso: Muestra tendencias de calidad y mejora a lo largo del tiempo
  • 🌐 Panel web: Interfaz limpia para ver historial, análisis e información

Características

Funcionalidad principal

  • ✅ Herramientas MCP interactivas para integración con Claude Desktop
  • ✅ Base de datos SQLite para almacenamiento local (sin sincronización en la nube)
  • ✅ Puntuación de calidad de prompts en tiempo real
  • ✅ Panel web con análisis
  • ✅ Generación automatizada de información

Herramientas disponibles

  • log_prompt - Registra y analiza un prompt con retroalimentación inmediata de calidad
  • improve_prompt - Obtén sugerencias específicas para mejorar cualquier prompt
  • get_prompt_insights - Consulta análisis y patrones de tu historial de prompts
  • view_stats - Muestra estadísticas completas y tendencias de calidad

Motor de análisis

  • Puntuación de calidad: Puntuación de 0-10 basada en estructura, claridad y completitud
  • Detección de complejidad: Clasifica prompts como simples, moderados o complejos
  • Sugerencias de técnicas: Recomienda técnicas óptimas de prompting
  • Detección de problemas: Identifica ambigüedad, contexto faltante, sesgo, etc.

Características del panel

  • Historial de prompts con búsqueda y filtrado
  • Tendencias de calidad a lo largo del tiempo
  • Gráficos de distribución de complejidad
  • Resumen de actividad reciente
  • Información de mejora accionable

Uso

En Claude Desktop

Una vez que el servidor MCP esté en ejecución, tendrás acceso a estas herramientas en Claude Desktop:

log_prompt
- Use: Log and analyze any prompt
- Example: "log_prompt" with your prompt text
- Returns: Quality score, complexity, and improvement suggestions

improve_prompt  
- Use: Get specific suggestions for a prompt
- Example: "improve_prompt" with your prompt and optional goal
- Returns: Detailed analysis and actionable improvement recommendations

get_prompt_insights
- Use: View patterns and insights from your prompt history
- Example: "get_prompt_insights" optionally filtered by category
- Returns: Analytics on your prompting patterns and common issues

view_stats
- Use: See comprehensive statistics and trends
- Example: "view_stats" for last 30 days (configurable)
- Returns: Total prompts, quality trends, complexity breakdown

Comandos de desarrollo

# Build and run
npm run build                       # Build TypeScript
npm run dev                         # Development mode with auto-reload
npm start                          # Start the MCP server

# Code quality
npm test                           # Run tests
npm run lint                       # Check code style
npm run format                     # Format code

Cómo funciona

  1. Integración MCP: Se registra como servidor MCP con Claude Desktop
  2. Herramientas interactivas: Proporciona 4 herramientas accesibles a través de la interfaz de Claude Desktop
  3. Registro manual: Los usuarios registran prompts explícitamente usando la herramienta log_prompt
  4. Análisis: Evalúa calidad, detecta patrones, identifica mejoras
  5. Almacenamiento: Guarda todo localmente en la base de datos SQLite
  6. Información: Genera sugerencias personalizadas basadas en tus patrones
  7. Panel: Proporciona interfaz web para ver análisis e historial

Configuración

La configuración predeterminada se almacena en ~/.mcp-prompt-collector/config/settings.json:

{
  "name": "mcp-prompt-collector",
  "capabilities": {
    "intercept": true,
    "modify": false,
    "store": true
  },
  "settings": {
    "enhancePrompts": false,
    "storageLocation": "~/.mcp-prompt-collector/data",
    "dashboardPort": 3456,
    "analysisLevel": "detailed",
    "retentionDays": 90
  }
}

Almacenamiento de datos

Todos los datos se almacenan localmente en la base de datos SQLite:

  • Ubicación: ~/.mcp-prompt-collector/data/prompt_history.db
  • Privacidad: Sin sincronización en la nube, control local completo
  • Retención: Limpieza configurable después de N días
  • Exportación: Capacidades completas de exportación de datos

Desarrollo

# Clone and setup
git clone <repo-url>
cd mcp-prompt-collector
npm install

# Development workflow
npm run dev        # Watch mode
npm run build      # Production build
npm test          # Run tests
npm run lint      # Code quality

# Testing
npm run test:unit        # Unit tests
npm run test:integration # Integration tests

Arquitectura

  • Manejador de protocolo MCP: Se comunica con Claude Desktop
  • Gestor de almacenamiento: Operaciones de base de datos SQLite
  • Motor de análisis: Puntuación de calidad de prompts e información
  • Servidor del panel: Interfaz web Express.js
  • Trabajador en segundo plano: Análisis y limpieza programados

Privacidad y seguridad

  • ✅ Solo local: Todos los datos permanecen en tu máquina
  • ✅ Sin sincronización en la nube: Cero transmisión de datos externa
  • ✅ Control del usuario: Propiedad completa de los datos y exportación
  • ✅ Transparente: Código abierto y auditable

Requisitos

  • Node.js: 18+
  • Claude Desktop: Última versión con soporte MCP
  • macOS: Soporte principal (Windows/Linux próximamente)

Solución de problemas

El servidor no se inicia

  • Verifica si el puerto 3456 está disponible
  • Verifica la configuración MCP de Claude Desktop
  • Ejecuta mcp-prompt-collector status para diagnósticos

No aparecen prompts en el panel

  • Asegúrate de estar usando la herramienta log_prompt en Claude Desktop
  • Los prompts no se capturan automáticamente; debes registrarlos manualmente
  • Verifica que las herramientas del servidor MCP estén disponibles en Claude Desktop

El panel no carga

  • Verifica si el servidor se está ejecutando en el puerto correcto
  • Prueba con un puerto diferente usando setup --port 3457
  • Revisa la consola del navegador para ver errores

Licencia

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