Problem Solving MCP Server

Un servidor inteligente de resolución de problemas que forma automáticamente equipos multirrol y utiliza la matriz de Eisenhower para la gestión eficiente de tareas y la colaboración.

GitHub

Documentación

🚀 Servidor MCP de Resolución de Problemas

Marco de Resolución Colaborativa de Problemas Multi-Rol Basado en el Protocolo de Contexto de Modelo

📖 Navegación de Documentación

Documento	Descripción	Idioma
README.md	Documentación completa del proyecto	中文
README.md	Documentación completa del proyecto	Inglés
INSTALLATION.md	Guía de instalación y configuración	Inglés
QUICK_START.md	Guía de inicio rápido (5 minutos)	Inglés
example-usage.md	Ejemplos de uso detallados	Inglés
安装指南	安装和配置指南	中文
快速开始	5分钟快速配置	中文
使用示例	详细使用示例	中文

🌟 Visión General

Este es un servidor MCP inteligente de resolución de problemas que crea 3-12 roles profesionales según la complejidad del problema, utiliza la Matriz de Eisenhower para la gestión de prioridades e implementa optimización de procesamiento paralelo para generar soluciones integrales, ejecutables y eficientes.

✨ Características Principales

🎭 Configuración Inteligente de Equipos: Recomienda automáticamente equipos de 3-12 miembros según la complejidad del problema
🔍 Aseguramiento de Calidad Multidimensional: Verificaciones integrales de completitud, viabilidad, calidad, riesgo y cronograma
⚡ Optimización de Procesamiento Paralelo: Detecta automáticamente tareas repetitivas y expande equipos (hasta 30 miembros)
📊 Análisis de Matriz de Eisenhower: Análisis de cuadrantes importante-urgente para la gestión de prioridades
🤝 Colaboración Multi-Rol: 12 tipos de roles profesionales para una resolución integral de problemas
💡 Reflexión y Mejora: Mecanismo de reflexión integrado para la optimización continua

🛠️ Configuración Rápida

En Cursor

{
  "mcpServers": {
    "problem-solving": {
      "command": "node",
      "args": ["/path/to/problem-solving-mcp/dist/index.js"],
      "cwd": "/path/to/problem-solving-mcp",
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

En Claude Desktop

{
  "mcpServers": {
    "problem-solving": {
      "command": "node", 
      "args": ["/path/to/problem-solving-mcp/dist/index.js"],
      "cwd": "/path/to/problem-solving-mcp",
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Nota: Reemplace /path/to/problem-solving-mcp con la ruta real de su proyecto

🎯 Documentación de API

Herramientas Principales (4)

Herramienta	Descripción	Parámetros
`create_problem`	Crear definición del problema	title, description, domain, complexity_score
`solve_problem`	Resolución inteligente de problemas (función principal)	problem_id
`get_role_recommendations`	Obtener sugerencias de configuración de roles	problem_id
`check_solution`	Verificar la calidad de la solución	problem_id

Herramientas de Gestión (4)

Herramienta	Descripción	Parámetros
`get_problem_history`	Ver historial de problemas	-
`get_team_status`	Ver estado del equipo	problem_id
`update_team_member`	Actualizar miembro del equipo	problem_id, role_id, updates
`assign_task`	Asignar tareas	problem_id, task, assigned_to, priority

Herramientas de Análisis (4)

Herramienta	Descripción	Parámetros
`eisenhower_matrix_analysis`	Análisis de cuadrantes importante-urgente	problem_id
`analyze_task_dependencies`	Análisis de dependencias de tareas	problem_id
`optimize_parallel_execution`	Optimización de ejecución paralela	problem_id
`get_execution_report`	Obtener informe de ejecución	problem_id

Herramientas de Reflexión (3)

Herramienta	Descripción	Parámetros
`create_reflection`	Crear registro de reflexión	problem_id, phase, insights, lessons_learned
`get_reflection_summary`	Obtener resumen de reflexión	problem_id
`improve_solution`	Mejorar la solución	problem_id, feedback

🏗️ Arquitectura del Sistema

graph TB
    A[Problem Input] --> B[Role Creator]
    B --> C[Team Assembly]
    C --> D[Solution Generation]
    D --> E[Result Checker]
    E --> F{Quality Check}
    F -->|Pass| G[Execution Plan]
    F -->|Fail| H[Improvement Suggestions]
    H --> D
    G --> I[Parallel Optimizer]
    I --> J[Team Expansion]
    J --> K[Parallel Execution]
    K --> L[Coordinator]
    L --> M[Final Solution]
    M --> N[Reflection & Learning]
    
    subgraph "Core Components"
        B
        E
        L
        I
    end
    
    subgraph "Quality Assurance"
        F
        H
        N
    end
    
    subgraph "Execution Optimization"
        I
        J
        K
    end

🎭 Componentes Principales

1. Creador de Roles (`role-creator.ts`)

Función: Crea inteligentemente equipos profesionales según las características del problema
Tamaño del Equipo: 3-12 miembros (ampliable a 30 para procesamiento paralelo)
Tipos de Roles: 12 roles profesionales que incluyen analista, investigador, diseñador, desarrollador, etc.
Coincidencia Inteligente: Selecciona roles principales y de apoyo según el dominio y la complejidad del problema

2. Verificador de Resultados (`result-checker.ts`)

Evaluación Multidimensional: Completitud, viabilidad, calidad, riesgo y cronograma
Identificación de Problemas: Clasifica problemas por severidad (baja, media, alta, crítica)
Sugerencias de Mejora: Genera recomendaciones específicas y accionables
Sistema de Puntuación: Puntuación integral (0-100) con decisiones de aprobación

3. Coordinador (`coordinator.ts`)

Gestión de Procesos: Orquestación completa del flujo de trabajo de resolución de problemas
Dependencias de Tareas: Gestiona relaciones entre tareas y ejecución paralela
Seguimiento de Progreso: Monitoreo en tiempo real del avance de la solución
Control de Calidad: Soporte para múltiples rondas de mejora e iteración

4. Optimizador Paralelo (`parallel-optimizer.ts`)

Análisis de Tareas: Evalúa la repetitividad y la carga de trabajo
Expansión del Equipo: Escalado inteligente según el análisis de carga de trabajo
Subdivisión de Roles: Procesamiento paralelo multi-rol para una única función
Objetivo de Eficiencia: Meta de mejora de rendimiento de 2.5x

🚀 Mejores Prácticas

Definición del Problema

// Good example
{
  title: "Develop AI Customer Service System",
  description: "Develop intelligent customer service system for e-commerce platform, supporting multi-turn dialogue, sentiment analysis, and automatic replies",
  domain: "software_development", 
  complexity_score: 8
}

Configuración del Equipo

Problemas Simples (1-3): 3-5 miembros, roles principales
Problemas Medianos (4-6): 6-8 miembros, roles principales + de apoyo
Problemas Complejos (7-10): 9-12 miembros, equipo profesional completo

Gestión de Prioridades

Use la Matriz de Eisenhower para la priorización de tareas:

Urgente e Importante: Acción inmediata
Importante y No Urgente: Ejecución planificada
Urgente y No Importante: Delegar o automatizar
No Urgente y No Importante: Eliminar o posponer

⚙️ Configuración y Extensión

Variables de Entorno

NODE_ENV=production          # Production mode
DEBUG_MODE=false            # Debug mode
MAX_TEAM_SIZE=30           # Maximum team size
PARALLEL_THRESHOLD=0.7     # Parallel processing threshold

Tipos de Roles Personalizados

// Extend role types in types.ts
export enum RoleType {
  // ... existing roles
  custom_specialist = 'custom_specialist'
}

📊 Métricas de Rendimiento

Mejoras de Eficiencia

Expansión del Equipo: Hasta 30 miembros para tareas complejas
Procesamiento Paralelo: Objetivo de mejora de eficiencia de 2.5x
Aseguramiento de Calidad: Sistema de puntuación multidimensional
Optimización por Iteración: Mejora continua basada en reflexión

Asignación de Recursos

Basada en Capacidades: Distribución de carga de trabajo basada en capacidades de roles
Prevención de Conflictos: Evita conflictos de recursos
Balanceo de Carga Dinámico: Ajuste de carga de trabajo en tiempo real

🧪 Pruebas y Depuración

Modo de Desarrollo

npm run dev

Registro de Depuración

NODE_ENV=development npm start

Comandos de Prueba

# Basic functionality test
npm test

# Integration test
npm run test:integration

# Performance test
npm run test:performance

🚀 Despliegue y Operaciones

Despliegue en Producción

# Build project
npm run build

# Start service
npm start

# Process management (PM2)
pm2 start dist/index.js --name problem-solving-mcp

Monitoreo

Verificaciones de Salud: Monitoreo del estado del servicio
Métricas de Rendimiento: Seguimiento de tiempo de respuesta y tasa de éxito
Registro de Errores: Registro integral de errores y alertas

Escalado

Escalado Horizontal: Múltiples instancias de servicio
Balanceo de Carga: Distribución de solicitudes
Monitoreo de Recursos: Seguimiento de uso de CPU y memoria

🤝 Comunidad y Soporte

Obtención de Ayuda

📧 Correo electrónico: your-email@example.com
🐛 Reporte de Problemas: GitHub Issues
📖 Documentación: Wiki
💬 Comunidad: Discord

Contribuciones

🔧 Contribuciones de Código: Siga nuestra Guía de Contribución
📝 Documentación: Ayude a mejorar la documentación
🐛 Reportes de Errores: Reporte problemas con información detallada
💡 Solicitudes de Funciones: Sugiera nuevas funcionalidades

🗺️ Hoja de Ruta

Versión 1.1

Soporte de almacenamiento persistente (PostgreSQL, MongoDB)
Interfaz de panel web
Endpoints de API RESTful
Mercado de plantillas de roles

Versión 1.2

Recomendaciones de roles basadas en aprendizaje automático
Algoritmos avanzados de procesamiento paralelo
Integración con herramientas externas de gestión de proyectos
Expansión de soporte multi-idioma

Versión 2.0

Arquitectura de procesamiento distribuido
Funciones de colaboración en tiempo real
Análisis avanzado e informes
Funciones de seguridad de nivel empresarial

📄 Licencia

Licencia MIT: consulte el archivo LICENSE para obtener más detalles

🎉 ¡Felicidades! ¡Su Servidor MCP de Resolución de Problemas está listo!

¡Comience a disfrutar del poder de la resolución inteligente de problemas! 🚀✨