🤖 MCP & HAHU Generator

Extensión completa para VS Code que combina configuración automática de MCP (Model Context Protocol) con un asistente inteligente para crear Work Items en Azure DevOps.

✨ Características Principales

🚀 Nueva Interfaz Simplificada (v1.0.0)

La extensión ahora cuenta con 6 comandos principales organizados de forma intuitiva:

🎯 Comandos Principales

1. 🚀 Inicio Rápido - Configuración automática completa o por partes
2. ⚙️ Configurar MCP - Tokens, servidores y archivos de configuración
3. 🤖 Generar HAHU - Crear habilitadores, hooks y steering rules
4. 📋 Ver Configuración - Acceso rápido a todos los archivos de config
5. ✅ Validar Setup - Verificación completa del estado de configuración
6. 🔄 Reset Completo - Limpieza total de configuración

💡 Ventajas de la Nueva UI

• Menos confusión: De 14 comandos a 6 comandos principales
• Menús contextuales: Cada comando principal despliega opciones específicas
• Flujo guiado: Configuración paso a paso sin perderse
• Validación integrada: Verificación automática del estado

🎯 Interfaz Profesional

• Panel dedicado en Sidebar: Interfaz organizada con íconos y categorías
• Vista jerárquica: Configuración, Servidores y Acciones organizadas
• Feedback visual: Estados claros con íconos y colores

⚙️ Configuración Dinámica

• Token GitHub: Input seguro con validación de formato
• Organización Azure DevOps: Configurable (default: grupobancolombia)
• Servidores personalizados: Agregar, modificar y eliminar servidores MCP
• Persistencia: Toda la configuración se guarda automáticamente

🔌 Gestión de Servidores

• Servidores predefinidos: GitHub, Azure DevOps, AWS Docs
• Servidores personalizados: Soporte completo para cualquier servidor MCP
• Variables de entorno: Configuración de tokens y parámetros
• Estado visual: Indicadores de estado para cada servidor

🤖 HAHU Generator Avanzado

• Interfaz de pantalla completa: Panel WebView profesional para configuración
• Búsqueda automática de usuarios: Integración con Azure DevOps MCP para obtener IDs
• Configuración completa: Todos los parámetros del hook son configurables
• Líder técnico inteligente: Búsqueda por email con validación automática
• Proyecto y áreas: Configuración específica por organización
• Parámetros de trabajo: País, categoría, prioridad, puntos, tags
• Épicos configurables: IDs de épicos para diferentes tipos de trabajo
• Prompt personalizado: Opción de sobrescribir el comportamiento default
• Generación global y local: Crea hooks HAHU Generator tanto globales como específicos del workspace
• Validación en tiempo real: Verificación de formatos y datos

📚 Steering Rules Generator

• Generación automática: Crea reglas de steering basadas en la configuración actual
• Scope global y local: Steering disponible globalmente o por workspace
• Integración MCP: Enfatiza el uso del MCP de Azure DevOps instalado
• Configuración dinámica: Usa los parámetros configurados en HAHU Generator
• Ejemplos contextualizados: Genera ejemplos con la configuración actual
• Guías específicas: Instrucciones detalladas para crear work items

🚀 Acciones Avanzadas

• Generación inteligente: Crea configuración completa automáticamente
• Validación JSON: Verifica sintaxis y estructura del archivo
• Vista previa: Muestra la configuración antes de guardar
• Reset completo: Restaura valores por defecto
• Apertura directa: Acceso rápido al archivo de configuración
• Generación de hooks: Crea hooks HAHU Generator configurables globalmente

📋 Uso Detallado

1. Configuración Inicial

1. Abre VS Code y busca el ícono MCP en la barra lateral
2. Expande la sección "⚙️ Configuración"
3. Configura tu GitHub Token (obligatorio para servidor GitHub)
4. Configura tu Organización Azure DevOps (opcional, default: grupobancolombia)

2. Gestión de Servidores

• Ver servidores: Expande "🔌 Servidores MCP" para ver el estado
• Agregar servidor: Usa "Configurar Servidores" → "Agregar servidor personalizado"
• Eliminar servidor: Usa "Configurar Servidores" → "Eliminar servidor personalizado"

3. Configuración HAHU Generator Avanzada

Opciones de Acceso:

• Desde el Sidebar: Expande "🤖 HAHU Generator" → "Configuración HAHU Generator"
• Desde la Paleta: Ctrl+Shift+P → "HAHU Generator: Configuración Avanzada"

Panel de Configuración Completo:

• 👤 Líder Técnico:
  • Ingresa email y busca automáticamente el ID de Azure DevOps
  • Validación automática de usuarios con MCP
• 🏢 Proyecto y Áreas: Configuración específica de tu organización
• ⚙️ Parámetros de Trabajo: País, categoría, prioridad, puntos, tags
• 📋 Épicos: IDs de épicos para Soporte, Evolución y Seguridad
• 🎯 Prompt Personalizado: Sobrescribir comportamiento default

Acciones Disponibles:

• 🔄 Cargar configuración actual
• 💾 Guardar configuración
• 🚀 Generar hook global

4. Generación y Validación

1. Ve a la sección "🚀 Acciones"
2. Haz clic en "Generar Configuración MCP" para crear el archivo
3. Usa "Validar Configuración" para verificar la sintaxis
4. Usa "Abrir Archivo Config" para editar manualmente

🔧 Configuración Generada

La extensión genera ~/.kiro/settings/mcp.json con:

Servidores Predefinidos:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "tu-token"
      },
      "disabled": false,
      "autoApprove": []
    },
    "azuredevops": {
      "command": "npx",
      "args": ["-y", "@azure-devops/mcp", "tu-organizacion"],
      "disabled": false
    },
    "aws-docs": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": [],
      "disabledTools": []
    }
  }
}

Servidores Personalizados:

• Soporte completo para cualquier servidor MCP
• Variables de entorno configurables
• Argumentos personalizables
• Control de estado (habilitado/deshabilitado)

🎨 Mejoras de UI

Íconos Contextuales:

• ⚙️ Configuración MCP
• 🔌 Servidores MCP
• 🤖 HAHU Generator
• � Acciones
• 🔑 GitHub Token
• 🏢 Azure DevOps Org
• 👤 Líder Técnico
• 📄 Estado de Hooks
• ✅ Estados positivos
• ⚠️ Advertencias
• ❌ Errores

Organización Visual:

• Secciones colapsables: Mejor organización del contenido
• Descripciones claras: Cada elemento tiene su propósito explicado
• Estados visuales: Indicadores inmediatos del estado de configuración
• Tooltips informativos: Información adicional al pasar el mouse
• Configuración dual: MCP y HAHU Generator en una sola interfaz

🛠️ Desarrollo y Personalización

Instalación para Desarrollo:

git clone <repo>
cd mcp-config-generator
npm install
npm run compile

Ejecutar en Modo Desarrollo:

1. Abre el proyecto en VS Code
2. Presiona F5 para ejecutar la extensión
3. Se abrirá una nueva ventana con la extensión cargada

Empaquetado:

npm install -g vsce
vsce package

🔄 Generador de Hook HAHU Generator

La extensión genera dinámicamente el hook HAHU Generator con configuración personalizable:

📋 Configuración Completa:

• Líder Técnico: Nombre e ID completamente configurables
• Proyecto y Áreas: Adaptable a cualquier organización
• País: Colombia, Core, Guatemala, Panama
• Categorías: Desarrollo, Infraestructura, Seguridad, Datos, Investigación
• Parámetros de Trabajo: Prioridad, puntos, clasificación, tags
• Épicos: IDs configurables para Soporte, Evolución y Seguridad
• Prompt personalizado: Opción de sobrescribir comportamiento default

🎯 Funcionalidades del Hook Generado:

• Generación inteligente de Habilitadores y User Stories
• Detección automática de patrones técnicos (AWS, Seguridad, Infraestructura, etc.)
• Configuración dinámica según parámetros personalizados
• Estructura HAHU Generator con HTML y menciones dinámicas
• Asignación automática de épicos según tipo de trabajo detectado
• Integración MCP: Usa comandos MCP de Azure DevOps para crear work items
• Ubicación global: Se guarda en ~/.kiro/hooks/hahu-generator-global.kiro.hook
• Ubicación local: Se guarda en .kiro/hooks/hahu-generator-local.kiro.hook (específico del workspace)

📚 Funcionalidades del Steering Generado:

• Guías contextualizadas con la configuración actual del proyecto
• Ejemplos específicos usando los parámetros configurados
• Instrucciones MCP detalladas para usar Azure DevOps
• Patrones de detección automática de tipos de trabajo
• Estructura JSON completa para Habilitadores y User Stories
• Ubicación global: Se guarda en ~/.kiro/steering/EJEMPLO_HABILITADOR.md
• Ubicación local: Se guarda en .kiro/steering/EJEMPLO_HABILITADOR.md (específico del workspace)

🔧 Proceso de Configuración:

1. Configurar parámetros usando la interfaz visual
2. Generar hooks y steering con configuración personalizada:
   • Hook Global: Disponible en todos los workspaces
   • Hook Local: Específico del workspace actual
   • Steering Global: Reglas disponibles globalmente
   • Steering Local: Reglas específicas del workspace
3. Recursos disponibles según el alcance seleccionado
4. Actualización dinámica cuando cambies la configuración
5. Integración MCP: Steering enfatiza el uso del MCP de Azure DevOps

📝 Notas Importantes

• Seguridad: Los tokens se almacenan de forma segura en el estado global de VS Code
• Persistencia: Toda la configuración se mantiene entre sesiones
• Validación: Verificación automática de formatos y sintaxis
• Flexibilidad: Soporte completo para servidores MCP personalizados
• Profesional: Interfaz pulida y experiencia de usuario optimizada

🤝 Contribuciones

Las contribuciones son bienvenidas. Por favor:

1. Fork el repositorio
2. Crea una rama para tu feature
3. Commit tus cambios
4. Push a la rama
5. Abre un Pull Request