Agentic Tools MCP Companion

Una extensión de VS Code con interfaz gráfica para el servidor agentic-tools-mcp, que mejora la gestión de tareas y memoria.

GitHub
29
Prueba este MCPPatrocinado

Documentación

Agentic Tools MCP Companion

GitHub stars GitHub license Open VSX Version VS Code Version Node.js Version

Una hermosa extensión de VS Code que proporciona una interfaz GUI completa para la funcionalidad del servidor agentic-tools-mcp. Esta extensión te permite gestionar tareas y memorias directamente desde VS Code con una interfaz visual e intuitiva que incluye metadatos mejorados de tareas, gestión de prioridades y editores de formularios enriquecidos.

🔗 Ecosistema

Esta extensión de VS Code forma parte de un ecosistema completo de gestión de tareas y memorias:

  • 🖥️ Extensión de VS Code (este repositorio): interfaz GUI hermosa para gestionar tareas y memorias
  • ⚡ Servidor MCP: herramientas de línea de comandos y API para asistentes de IA

💡 Consejo profesional: ¡Usa ambos juntos para la máxima experiencia de productividad! El servidor MCP permite la integración con asistentes de IA mientras que esta extensión proporciona una interfaz visual.

Características

🎯 Gestión de tareas mejorada con jerarquía ilimitada (v0.1.0)

  • Vista de árbol de jerarquía ilimitada: Proyectos → Tareas → Subtareas → Sub-subtareas → anidación de profundidad infinita
  • Modelo de tarea unificado: interfaz de tarea única que admite anidación de profundidad ilimitada con indicadores visuales enriquecidos
  • Indicadores visuales por nivel: diferentes iconos y sangrías para cada nivel de jerarquía (L0, L1, L2, etc.)
  • Metadatos de tarea mejorados: prioridad (1-10), complejidad (1-10), flujo de estados, etiquetas y seguimiento de tiempo en cada nivel
  • Indicadores visuales de estado: ⏳ Pendiente, 🔄 En progreso, 🚫 Bloqueado, ✅ Completado con visualización de emojis
  • Insignias de prioridad y complejidad: 🔥 Prioridad alta (8+), ⚡ Prioridad media (6+), 🧩 Complejidad alta (8+)
  • Editores de formularios enriquecidos: formularios completos con diseño responsivo y validación
  • Seguimiento de tiempo: horas estimadas y reales con precisión decimal
  • Gestión de etiquetas: entrada de etiquetas separadas por comas para categorización y filtrado
  • Operaciones de profundidad ilimitada: crear, editar, mover y eliminar tareas en cualquier nivel de jerarquía
  • Selección y gestión de tareas padre: elige tareas padre en cualquier nivel de jerarquía durante la creación
  • Reorganización de jerarquía: mueve tareas entre cualquier nivel de jerarquía sin problemas
  • Información sobre herramientas enriquecida: pasa el cursor para ver información completa de la tarea, incluida la ruta de jerarquía y los metadatos
  • Migración automática: actualización sin problemas del antiguo modelo de 3 niveles al modelo de profundidad ilimitada
  • Actualizaciones en tiempo real: actualización automática cuando cambian los datos

📝 Formularios de tarea enriquecidos (compatible con MCP v1.7.0)

  • Selección de prioridad: menú desplegable de escala 1-10 con etiquetas descriptivas (de más baja a más alta)
  • Estimación de complejidad: menú desplegable de escala 1-10 con descripciones claras de complejidad
  • Gestión de estado: selección visual de estado con indicadores de emoji
  • Entrada de etiquetas: gestión de etiquetas separadas por comas con texto de ayuda
  • Seguimiento de tiempo: horas estimadas y reales con soporte de precisión decimal
  • Diseño responsivo: diseño de dos columnas que se adapta a diferentes tamaños de pantalla
  • Validación en tiempo real: validación en el lado del cliente con mensajes de error útiles
  • Texto de ayuda: orientación contextual para todos los campos del formulario

🧠 Gestión de memorias

  • Búsqueda basada en texto: encuentra memorias usando consultas en lenguaje natural con puntuación de relevancia
  • Organización por categorías: organiza memorias por categoría con estructura basada en directorios
  • Arquitectura de título + contenido: campos separados de título (máx. 50 caracteres) y contenido detallado
  • Almacenamiento en archivos JSON: archivos JSON legibles por humanos para fácil portabilidad y control de versiones

🔄 Compatibilidad de datos y metadatos mejorados

  • Compatible con MCP v1.7.0: soporte completo para metadatos de tarea mejorados (prioridad, complejidad, estado, etiquetas, seguimiento de tiempo)
  • Retrocompatible: funciona sin problemas con los datos existentes de agentic-tools-mcp
  • Mejora progresiva: los nuevos campos de metadatos son opcionales; las tareas existentes siguen funcionando
  • Mismos formatos de archivo: utiliza la misma estructura de directorio .agentic-tools-mcp
  • Operaciones atómicas: las operaciones de archivo atómicas y seguras evitan la corrupción de datos
  • Rastreable con Git: todos los datos se pueden confirmar junto con el código de tu proyecto

Requisitos

  • VSCode 1.96.0 o superior
  • Una carpeta de espacio de trabajo abierta
  • Node.js 18+ (para dependencias)

Instalación

Instalación de la extensión

  1. Abre VS Code
  2. Ve a la vista de Extensiones (Ctrl+Shift+X)
  3. Busca "Agentic Tools MCP Companion"
  4. Haz clic en "Instalar"
  5. Abre una carpeta de espacio de trabajo
  6. La barra lateral "Agentic Tools" aparecerá en la Barra de actividades

Instalación para desarrollo (solo para contribuidores)

  1. Clona o descarga este repositorio de la extensión
  2. Abre la carpeta de la extensión en VS Code
  3. Ejecuta npm install para instalar las dependencias
  4. Pulsa F5 para ejecutar la extensión en una nueva ventana de Host de Desarrollo de Extensiones
  5. Abre una carpeta de espacio de trabajo en la nueva ventana

Configuración completa (Servidor MCP + Extensión)

Para la experiencia completa con integración de asistentes de IA:

  1. Instala el Servidor MCP: npm install -g @pimzino/agentic-tools-mcp
  2. Configura Claude Desktop (o tu cliente MCP preferido): 
    {
  "mcpServers": {
    "agentic-tools": {
      "command": "npx",
      "args": ["-y", "@pimzino/agentic-tools-mcp"]
    }
  }
}
  3. Instala esta extensión de VS Code (sigue los pasos anteriores)
  4. Disfruta de la integración sin problemas entre la interfaz visual y los asistentes de IA

Uso

Primeros pasos

  1. Abre un espacio de trabajo: la extensión requiere una carpeta de espacio de trabajo abierta
  2. Accede a la barra lateral: haz clic en el icono "Agentic Tools" en la Barra de actividades
  3. Crea tu primer proyecto: haz clic en el botón "+" en la vista de Tareas
  4. Añade tareas y subtareas: haz clic derecho en proyectos y tareas para añadir elementos secundarios

Gestión de tareas mejorada

Árbol de tareas visual con jerarquía ilimitada

La extensión muestra tus tareas con indicadores visuales enriquecidos y profundidad ilimitada:

📁 Project: Website Redesign
├── 🔥⚡ Design mockups (L0: Priority: 8, Complexity: 6) [16h] ⏳
│   ├── ✅ Create wireframes (L1) [4h]
│   ├── 🔄 Design high-fidelity mockups (L1) [8h]
│   │   ├── ⏳ Homepage design (L2) [3h]
│   │   ├── ⏳ Product page design (L2) [3h]
│   │   └── ⏳ Contact page design (L2) [2h]
│   └── ⏳ Create design system (L1) [4h]
│       ├── ⏳ Color palette (L2) [1h]
│       ├── ⏳ Typography rules (L2) [1h]
│       └── ⏳ Component library (L2) [2h]
│           ├── ⏳ Button components (L3) [0.5h]
│           ├── ⏳ Form components (L3) [1h]
│           └── ⏳ Navigation components (L3) [0.5h]
├── 🧩 Backend API (L0: Priority: 7, Complexity: 9) [32h] 🚫
│   ├── ⏳ Database schema (L1) [8h]
│   ├── ⏳ User authentication (L1) [12h]
│   └── ⏳ API endpoints (L1) [12h]
└── ✅ Setup development environment (L0: Priority: 9, Complexity: 3) [4h] ✅

Indicadores visuales:

  • 🔥 Prioridad alta (8+), ⚡ Prioridad media (6+)
  • 🧩 Complejidad alta (8+)
  • ⏳ Pendiente, 🔄 En progreso, 🚫 Bloqueado, ✅ Completado
  • [16h] Visualización de horas estimadas
  • (L0, L1, L2, L3) Indicadores de nivel de jerarquía
  • Anidación de profundidad ilimitada con sangría adecuada

Operaciones con tareas

  • Crear proyecto: haz clic en el botón "+" en el título de la vista de Tareas
  • Crear tareas mejoradas: formularios enriquecidos con prioridad, complejidad, estado, etiquetas y seguimiento de tiempo
  • Editar elementos: haz clic derecho en cualquier elemento y selecciona "Editar" para editar metadatos completos
  • Alternar completado: haz clic derecho en tareas/subtareas y selecciona "Alternar completado"
  • Eliminar elementos: haz clic derecho y selecciona "Eliminar" (con confirmación)
  • Actualizar vista: haz clic en el botón de actualizar para recargar los datos

Gestión de tareas padre y movimiento de tareas

La extensión proporciona potentes capacidades para organizar tus tareas, permitiéndote seleccionar tareas padre durante la creación y mover elementos entre diferentes padres:

Selección de tarea padre durante la creación

  • Creación de tareas: al crear una nueva tarea, puedes seleccionar a qué proyecto pertenece desde una lista desplegable
  • Creación de subtareas: al crear una nueva subtarea, puedes elegir tanto el proyecto de destino como la tarea específica dentro de ese proyecto mediante un proceso de selección en dos pasos

Movimiento de elementos existentes

  • Mover tarea a proyecto: haz clic derecho en cualquier tarea y selecciona "Mover a proyecto" para reubicarla (junto con todas sus subtareas) en un proyecto diferente
  • Mover subtarea a tarea: haz clic derecho en cualquier subtarea y selecciona "Mover a tarea" para reubicarla en una tarea diferente, incluso entre proyectos

Funciones inteligentes

  • Movimientos entre proyectos: las subtareas se pueden mover entre tareas de diferentes proyectos sin problemas
  • Operaciones por lotes: al mover una tarea, todas sus subtareas se mueven con ella automáticamente
  • Validación: el sistema evita movimientos no válidos y proporciona comentarios claros
  • Diálogos de confirmación: los movimientos entre proyectos se confirman para evitar la reorganización accidental de datos
  • Actualización automática: la vista de árbol se actualiza automáticamente después de movimientos exitosos

Beneficios

  • Organización flexible: reorganiza tu jerarquía de tareas a medida que evoluciona tu proyecto
  • Reclasificación fácil: mueve tareas entre proyectos cuando cambian las prioridades
  • Flujo de trabajo eficiente: no es necesario eliminar y recrear tareas cuando cambia la estructura
  • Integridad de datos: todas las relaciones y el estado de completado se conservan durante los movimientos

Almacenamiento de datos

Todos los datos se almacenan en tu espacio de trabajo bajo .agentic-tools-mcp/:

your-workspace/
├── .agentic-tools-mcp/
│   ├── tasks/
│   │   └── tasks.json      # Projects, tasks, and subtasks
│   └── memories/           # Memory JSON files organized by category
│       ├── general/        # Default category
│       │   ├── memory1.json
│       │   └── memory2.json
│       └── user_preferences/
│           └── settings.json
├── src/
└── package.json

Configuración de la extensión

Esta extensión contribuye con las siguientes configuraciones:

  • agentic-tools.autoRefresh: actualizar automáticamente las vistas cuando cambian los archivos (predeterminado: true)

Problemas conocidos

  • La supervisión de archivos utiliza sondeo en lugar de eventos nativos del sistema de archivos
  • Los conjuntos de datos grandes pueden afectar el rendimiento
  • La búsqueda de memorias distingue entre mayúsculas y minúsculas y utiliza coincidencia de texto simple

Arquitectura y sincronización de datos

Esta extensión está diseñada para funcionar sin problemas con el servidor agentic-tools-mcp:

Compatibilidad de datos

  • 100% compatible: utiliza la misma estructura de directorio .agentic-tools-mcp
  • Mismos formatos de archivo: los archivos JSON son intercambiables entre la extensión y el servidor MCP
  • Operaciones atómicas: las operaciones de archivo seguras evitan la corrupción de datos
  • Sincronización en tiempo real: los cambios realizados en VS Code están inmediatamente disponibles para los asistentes de IA

Integración del flujo de trabajo

  1. Crear/Editar en VS Code: usa la hermosa GUI para gestionar tareas y memorias
  2. Acceso del asistente de IA: los asistentes de IA pueden leer y modificar los mismos datos a través del servidor MCP
  3. Colaboración en equipo: comparte datos mediante Git: ambas herramientas funcionan con los mismos archivos
  4. Copia de seguridad y migración: el almacenamiento simple basado en archivos viaja con tus proyectos

Beneficios de usar ambas herramientas

  • 🎯 Gestión visual: GUI enriquecida para jerarquías de tareas complejas
  • 🤖 Integración de IA: deja que los asistentes de IA ayuden con la planificación de tareas y la gestión de memorias
  • 👥 Colaboración en equipo: comparte listas de tareas y memorias mediante control de versiones
  • 📁 Específico del proyecto: cada espacio de trabajo tiene sus propios datos aislados
  • 🔄 Sincronización bidireccional: los cambios en cualquiera de las herramientas se reflejan en la otra

Proyectos relacionados

⚡ Servidor MCP

Servidor MCP de Agentic Tools: el servidor MCP complementario que permite la integración con asistentes de IA.

Características clave:

  • 🔧 Herramientas MCP mejoradas: conjunto completo de herramientas de gestión de tareas y memorias con soporte de metadatos enriquecidos
  • 🤖 Herramientas avanzadas para agentes de IA: análisis de PRD, recomendaciones de tareas, análisis de complejidad, inferencia de progreso y capacidades de investigación
  • 📦 Paquete NPM: instalación fácil con npm install -g @pimzino/agentic-tools-mcp
  • 🤖 Soporte para asistentes de IA: funciona con Claude Desktop, AugmentCode y otros clientes MCP
  • 🔄 Compatibilidad de datos: 100% compatible con esta extensión de VS Code

Colaboración perfecta:

  • Planificación humana: usa la extensión de VS Code para la planificación visual de tareas con metadatos enriquecidos
  • Ejecución de IA: los agentes de IA acceden a datos completos de tareas y utilizan herramientas avanzadas
  • Integración sin problemas: sincronización en tiempo real entre la interfaz visual y las capacidades de IA
  • Flujo de trabajo mejorado: creatividad humana + inteligencia artificial para una productividad óptima

Desarrollo

Para contribuir a esta extensión:

  1. Clona el repositorio
  2. Ejecuta npm install para instalar las dependencias
  3. Pulsa F5 para ejecutar en modo de desarrollo
  4. Realiza cambios y prueba en el Host de Desarrollo de Extensiones

Desarrollo con el servidor MCP

Para probar el ecosistema completo:

  1. Clona ambos repositorios: 
    git clone https://github.com/Pimzino/agentic-tools-mcp.git
git clone https://github.com/Pimzino/agentic-tools-mcp-companion.git
  2. Configura el servidor MCP: 
    cd agentic-tools-mcp
npm install && npm run build
  3. Configura la extensión de VS Code: 
    cd agentic-tools-mcp-companion
npm install
  4. Prueba ambas herramientas con los mismos datos del espacio de trabajo

Soporte

Para problemas y preguntas, utiliza el rastreador de problemas de GitHub.

Obtener ayuda

  • 🐛 Problemas de la extensión: informa problemas de la extensión de VS Code en este repositorio
  • ⚡ Problemas del servidor MCP: informa problemas del servidor MCP en agentic-tools-mcp
  • 💡 Solicitudes de funciones: usa los debates de GitHub para solicitudes de funciones
  • 📖 Documentación: consulta la documentación del servidor MCP para obtener una referencia detallada de la API

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENCIA para obtener más detalles.

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar issues y pull requests.

  1. Haz un fork del repositorio
  2. Crea tu rama de características (git checkout -b feature/amazing-feature)
  3. Haz commit de tus cambios (git commit -m 'Add some amazing feature')
  4. Haz push a la rama (git push origin feature/amazing-feature)
  5. Abre un Pull Request

¡Disfruta gestionando tus tareas y recuerdos con Agentic Tools MCP Companion!

Parte del ecosistema Agentic Tools: lleva la gestión de tareas y memoria impulsada por IA a tu flujo de trabajo.