目錄
- ✨ Características
- 🧭 Guía de uso
- 🔬 Modo de investigación
- Función de memoria de tareas
- 📋 Inicialización de las reglas del proyecto
- 🌐 Interfaz gráfica de usuario web
- Recursos de documentación
- 🔧 Instalación y uso
- 🔌 Uso con clientes compatibles con MCP
- 💡 Guía de indicaciones del sistema
- 🛠️ Descripción general de las herramientas disponibles
- 📄 Licencia
- 🤖 Modelos recomendados
Administrador de tareas de MCP Shrimp
🚀 Un sistema de gestión de tareas inteligente basado en el Protocolo de Contexto de Modelo (MCP), que proporciona un marco de flujo de trabajo de programación eficiente para agentes de IA.
Shrimp Task Manager guía a los agentes a través de flujos de trabajo estructurados para una programación sistemática, mejorando los mecanismos de gestión de la memoria de tareas y evitando de forma eficaz el trabajo de codificación redundante y repetitivo.
✨ Características
- Planificación y análisis de tareas : comprensión y análisis profundos de los requisitos de tareas complejas
- Descomposición inteligente de tareas : divida automáticamente las tareas grandes en tareas más pequeñas y manejables.
- Gestión de dependencias : gestione con precisión las dependencias entre tareas, garantizando un orden de ejecución correcto
- Seguimiento del estado de ejecución : monitoreo en tiempo real del progreso y el estado de la ejecución de tareas
- Verificación de la integridad de la tarea : garantizar que los resultados de la tarea cumplan con los requisitos esperados
- Evaluación de la complejidad de la tarea : evalúa automáticamente la complejidad de la tarea y proporciona sugerencias de manejo óptimo
- Actualizaciones automáticas de resumen de tareas : genere resúmenes automáticamente al completar la tarea, optimizando el rendimiento de la memoria
- Función de memoria de tareas : realiza copias de seguridad automáticas del historial de tareas, lo que proporciona memoria a largo plazo y capacidades de referencia.
- Modo de investigación : capacidades de investigación técnica sistemática con flujos de trabajo guiados para explorar tecnologías, mejores prácticas y comparaciones de soluciones.
- Inicialización de reglas del proyecto : definir estándares y reglas del proyecto para mantener la coherencia en proyectos grandes
- Interfaz gráfica de usuario web : Proporciona una interfaz gráfica de usuario web opcional para la gestión de tareas. Habilítela configurando
ENABLE_GUI=true
en su archivo.env
. Al habilitarla, se creará un archivoWebGUI.md
con la dirección de acceso en suDATA_DIR
.
🧭 Guía de uso
Shrimp Task Manager ofrece un enfoque estructurado para la programación asistida por IA a través de flujos de trabajo guiados y gestión sistemática de tareas.
¿Qué es el camarón?
Shrimp es básicamente una plantilla de indicaciones que guía a los agentes de IA para comprender y trabajar mejor con tu proyecto. Utiliza una serie de indicaciones para garantizar que el agente se ajuste perfectamente a las necesidades y convenciones específicas de tu proyecto.
El modo de investigación en la práctica
Antes de comenzar a planificar tareas, puede aprovechar el modo de investigación para la investigación técnica y la recopilación de conocimientos. Esto es especialmente útil cuando:
- Necesitas explorar nuevas tecnologías o marcos
- Quiere comparar diferentes enfoques de solución.
- Estás investigando las mejores prácticas para tu proyecto.
- Necesitas comprender conceptos técnicos complejos
Simplemente dígale al Agente "investigue [su tema]" o "inicie sesión en modo de investigación para [tecnología/problema]" para iniciar una investigación sistemática. Los resultados de la investigación le servirán de base para la planificación de tareas y las decisiones de desarrollo posteriores.
Configuración por primera vez
Al trabajar con un nuevo proyecto, simplemente indique al Agente "iniciar reglas del proyecto". Esto le ayudará a generar un conjunto de reglas adaptado a los requisitos y la estructura específicos de su proyecto.
Proceso de planificación de tareas
Para desarrollar o actualizar funciones, utilice el comando "planificar tarea [su descripción]". El sistema consultará las reglas previamente establecidas, intentará comprender su proyecto, buscará secciones de código relevantes y propondrá un plan integral basado en el estado actual de su proyecto.
Mecanismo de retroalimentación
Durante el proceso de planificación, Shrimp guía al Agente a través de múltiples pasos de pensamiento. Puedes revisar este proceso y brindar retroalimentación si consideras que va por mal camino. Simplemente interrumpe y comparte tu perspectiva; el Agente incorporará tus comentarios y continuará con el proceso de planificación.
Ejecución de tareas
Cuando esté satisfecho con el plan, utilice "Ejecutar tarea [nombre o ID de la tarea]" para implementarlo. Si no especifica un nombre o ID de tarea, el sistema identificará y ejecutará automáticamente la tarea de mayor prioridad.
Modo continuo
Si prefiere ejecutar todas las tareas en secuencia sin intervención manual para cada tarea, utilice el "modo continuo" para procesar automáticamente toda la cola de tareas.
Nota sobre limitación de tokens
Debido a los límites de tokens LLM, es posible que se pierda el contexto durante conversaciones largas. Si esto ocurre, simplemente abra una nueva sesión de chat y pida al agente que continúe la ejecución. El sistema retomará la tarea donde la dejó sin necesidad de repetir los detalles ni el contexto.
Idioma del mensaje y personalización
Puede cambiar el idioma de los mensajes del sistema configurando la variable de entorno TEMPLATES_USE
. Admite en
(inglés) y zh
(chino tradicional) de forma predeterminada. Además, puede copiar un directorio de plantillas existente (p. ej., src/prompts/templates_en
) a la ubicación especificada por DATA_DIR
, modificarlo y luego usar TEMPLATES_USE
para apuntar el nombre del directorio de plantillas personalizado. Esto permite una personalización más completa de los mensajes. Para obtener instrucciones detalladas, consulte.
🔬 Modo de investigación
Shrimp Task Manager incluye un modo de investigación especializado diseñado para la investigación técnica sistemática y la recopilación de conocimientos.
¿Qué es el modo de investigación?
El Modo de Investigación es un sistema de flujo de trabajo guiado que ayuda a los agentes de IA a realizar investigaciones técnicas exhaustivas y sistemáticas. Ofrece enfoques estructurados para explorar tecnologías, comparar soluciones, investigar las mejores prácticas y recopilar información completa para las tareas de programación.
Características principales
- Investigación sistemática : los flujos de trabajo estructurados garantizan una cobertura integral de los temas de investigación.
- Investigación de múltiples fuentes : combina la búsqueda web y el análisis de la base de código para una comprensión completa
- Gestión estatal : mantiene el contexto y el progreso de la investigación a lo largo de múltiples sesiones
- Exploración guiada : evita que la investigación se desvíe del tema o se desvíe del tema.
- Integración de conocimientos : integra sin problemas los resultados de la investigación con la planificación y ejecución de tareas.
Cuándo utilizar el modo de investigación
El modo de investigación es particularmente valioso para:
- Exploración de tecnología : investigación de nuevos marcos, bibliotecas o herramientas
- Investigación de mejores prácticas : búsqueda de estándares de la industria y enfoques recomendados
- Comparación de soluciones : evaluación de diferentes enfoques técnicos o arquitecturas
- Investigación de problemas : análisis profundo de desafíos técnicos complejos
- Planificación de la arquitectura : investigación de patrones de diseño y arquitecturas de sistemas
Cómo utilizar el modo de investigación
Simplemente dígale al Agente que ingrese al modo de investigación con su tema:
- Uso básico : "Ingresar al modo de investigación para [su tema]"
- Investigación específica : "Investigación [tecnología/problema específico]"
- Análisis comparativo : "Investigar y comparar [opciones A vs. B]"
El sistema guiará al Agente a través de fases de investigación estructuradas, garantizando una investigación exhaustiva y manteniendo el enfoque en sus necesidades específicas.
Flujo de trabajo de investigación
- Definición del tema : Definir claramente el alcance y los objetivos de la investigación.
- Recopilación de información : recopilación sistemática de información relevante
- Análisis y síntesis : procesamiento y organización de los hallazgos
- Actualizaciones estatales : seguimiento regular del progreso y preservación del contexto
- Integración : Aplicación de los resultados de la investigación al contexto de su proyecto
💡 Recomendación : para obtener la mejor experiencia en el modo de investigación, recomendamos utilizar Claude 4 Sonnet , que proporciona capacidades analíticas excepcionales y una síntesis de investigación integral.
Función de memoria de tareas
Shrimp Task Manager tiene capacidades de memoria a largo plazo, guardando automáticamente el historial de ejecución de tareas y proporcionando experiencias de referencia al planificar nuevas tareas.
Características principales
- El sistema realiza automáticamente copias de seguridad de las tareas en el directorio de memoria
- Los archivos de respaldo se nombran en orden cronológico, en el formato tareas_respaldo_AAAA-MM-DDThh-mm-ss.json
- Planificación de tareas Los agentes reciben automáticamente orientación sobre cómo utilizar la función de memoria
Ventajas y beneficios
- Evite el trabajo duplicado : haga referencia a tareas pasadas, sin necesidad de resolver problemas similares desde cero
- Aprenda de experiencias exitosas : utilice soluciones efectivas comprobadas, mejore la eficiencia del desarrollo
- Aprendizaje y mejora : identificar errores pasados o soluciones ineficientes, optimizar continuamente los flujos de trabajo
- Acumulación de conocimientos : Formar una base de conocimientos en continua expansión a medida que aumenta el uso del sistema
Mediante el uso eficaz de la función de memoria de tareas, el sistema puede acumular experiencia de forma continua, y el nivel de inteligencia y la eficiencia del trabajo mejoran continuamente.
📋 Inicialización de las reglas del proyecto
La función Reglas del proyecto ayuda a mantener la coherencia en toda su base de código:
- Estandarizar el desarrollo : establecer patrones y prácticas de codificación consistentes
- Incorporar nuevos desarrolladores : proporcionar pautas claras para las contribuciones al proyecto
- Mantener la calidad : garantizar que todo el código cumpla con los estándares de proyecto establecidos
⚠️ Recomendación : Inicialice las reglas del proyecto cuando crezca o experimente cambios significativos. Esto ayuda a mantener la consistencia y la calidad a medida que aumenta la complejidad.
Utilice la herramienta init_project_rules
para configurar o actualizar los estándares del proyecto cuando:
- Iniciando un nuevo proyecto a gran escala
- Incorporación de nuevos miembros al equipo
- Implementación de cambios arquitectónicos importantes
- Adopción de nuevas convenciones de desarrollo
Ejemplos de uso
Puede acceder fácilmente a esta función con simples comandos en lenguaje natural:
- Para la configuración inicial : simplemente dígale al agente "reglas de inicio" o "reglas de inicio del proyecto".
- Para actualizaciones : Cuando su proyecto evolucione, dígale al Agente "Actualizar reglas" o "Actualizar reglas del proyecto"
Esta herramienta es particularmente valiosa cuando su base de código se expande o sufre cambios estructurales significativos, lo que ayuda a mantener prácticas de desarrollo consistentes durante todo el ciclo de vida del proyecto.
Recursos de documentación
- Guía de personalización de indicaciones : instrucciones para personalizar las indicaciones de la herramienta mediante variables de entorno
- Registro de cambios : registro de todos los cambios notables en este proyecto
🔧 Instalación y uso
Instalación mediante herrería
Para instalar Shrimp Task Manager para Claude Desktop automáticamente a través de Smithery :
Instalación manual
🔌 Uso con clientes compatibles con MCP
Shrimp Task Manager se puede utilizar con cualquier cliente que admita el Protocolo de contexto de modelo, como Cursor IDE.
Configuración en Cursor IDE
Shrimp Task Manager ofrece dos métodos de configuración: configuración global y configuración específica del proyecto.
Configuración global
- Abra el archivo de configuración global de Cursor IDE (generalmente ubicado en
~/.cursor/mcp.json
) - Agregue la siguiente configuración en la sección
mcpServers
:
⚠️ Reemplace
/mcp-shrimp-task-manager
con su ruta actual.
Configuración específica del proyecto
También puede configurar configuraciones dedicadas para cada proyecto para utilizar directorios de datos independientes para diferentes proyectos:
- Cree un directorio
.cursor
en la raíz del proyecto - Cree un archivo
mcp.json
en este directorio con el siguiente contenido:
⚠️ Notas de configuración importantes
El parámetro DATA_DIR es el directorio donde Shrimp Task Manager almacena datos de tareas, registros de conversaciones y otra información. Configurar este parámetro correctamente es crucial para el correcto funcionamiento del sistema. Este parámetro debe usar una ruta absoluta ; usar una ruta relativa puede provocar que el sistema ubique incorrectamente el directorio de datos, lo que puede provocar la pérdida de datos o un fallo de funcionamiento.
Advertencia : el uso de rutas relativas puede provocar los siguientes problemas:
- No se encontraron archivos de datos, lo que provoca un error en la inicialización del sistema
- Pérdida del estado de la tarea o imposibilidad de guardarla correctamente
- Comportamiento inconsistente de las aplicaciones en diferentes entornos
- El sistema se bloquea o no se puede iniciar
🔧 Configuración de variables de entorno
El Administrador de Tareas de Shrimp permite personalizar el comportamiento de los mensajes mediante variables de entorno, lo que permite ajustar las respuestas del asistente de IA sin modificar el código. Puede configurar estas variables en la configuración o mediante un archivo .env
:
Hay dos métodos de personalización:
- Modo de anulación (
MCP_PROMPT_[FUNCTION_NAME]
): reemplaza por completo el mensaje predeterminado - Modo de anexión (
MCP_PROMPT_[FUNCTION_NAME]_APPEND
): agrega contenido al mensaje existente
Además, existen otras variables de configuración del sistema:
- DATA_DIR : especifica el directorio donde se almacenan los datos de la tarea
- TEMPLATES_USE : Especifica el conjunto de plantillas que se usará para las indicaciones. El valor predeterminado es
en
. Las opciones disponibles actualmente sonen
yzh
. Para usar plantillas personalizadas, copie el directoriosrc/prompts/templates_en
a la ubicación especificada porDATA_DIR
, cambie el nombre del directorio copiado (p. ej., amy_templates
) y configureTEMPLATES_USE
con el nuevo nombre del directorio (p. ej.,my_templates
).
Para obtener instrucciones detalladas sobre cómo personalizar los mensajes, incluidos los parámetros admitidos y ejemplos, consulte la Guía de personalización de mensajes .
💡 Guía de indicaciones del sistema
Configuración de IDE del cursor
Puede habilitar Configuración del cursor => Funciones => Modos personalizados y configurar los dos modos siguientes:
Modo Planificador de tareas
Modo TaskExecutor
💡 Elige el modo adecuado según tus necesidades:
- Utilice el modo TaskPlanner al planificar tareas
- Utilice el modo TaskExecutor al ejecutar tareas
Uso con otras herramientas
Si su herramienta no admite modos personalizados, puede:
- Pegue manualmente las indicaciones apropiadas en diferentes etapas
- O utilice directamente comandos simples como
Please plan the following task: ......
oPlease start executing the task...
🛠️ Descripción general de las herramientas disponibles
Después de la configuración, puede utilizar las siguientes herramientas:
Categoría | Nombre de la herramienta | Descripción |
---|---|---|
Planificación de tareas | plan_task | Comience a planificar tareas |
Análisis de tareas | analyze_task | Análisis en profundidad de los requisitos de la tarea |
process_thought | Razonamiento paso a paso para problemas complejos | |
Evaluación de la solución | reflect_task | Reflexionar y mejorar los conceptos de solución |
Investigación e investigación | research_mode | Entrar en el modo de investigación técnica sistemática |
Gestión de proyectos | init_project_rules | Inicializar o actualizar los estándares y reglas del proyecto |
Gestión de tareas | split_tasks | Dividir las tareas en subtareas |
list_tasks | Mostrar todas las tareas y estados | |
query_task | Buscar y enumerar tareas | |
get_task_detail | Mostrar detalles completos de la tarea | |
delete_task | Eliminar tareas incompletas | |
Ejecución de tareas | execute_task | Ejecutar tareas específicas |
verify_task | Verificar la finalización de la tarea |
🔧 Implementación técnica
- Node.js : entorno de ejecución de JavaScript de alto rendimiento
- TypeScript : proporciona un entorno de desarrollo seguro para tipos
- MCP SDK : Interfaz para una interacción fluida con modelos de lenguaje grandes
- UUID : Generar identificadores de tareas únicos y confiables
📄 Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
Modelos recomendados
Para obtener la mejor experiencia, recomendamos utilizar los siguientes modelos:
- Claude 3.7 : Ofrece fuertes capacidades de comprensión y generación.
- Gemini 2.5 : El último modelo de Google, tiene un rendimiento excelente.
Debido a las diferencias en los métodos de entrenamiento y las capacidades de comprensión entre los modelos, el uso de otros modelos podría generar resultados distintos para las mismas indicaciones. Este proyecto se ha optimizado para Claude 3.7 y Gemini 2.5.
Historia de las estrellas
You must be authenticated.
El Administrador de Tareas MCP Shrimp es una herramienta diseñada para agentes de IA, que prioriza la cadena de pensamiento, la reflexión y la coherencia de estilo. Convierte el lenguaje natural en tareas de desarrollo estructuradas con seguimiento de dependencias y refinamiento iterativo, lo que permite un comportamiento de desarrollador similar al de un agente en sistemas de IA de razonamiento.
- Administrador de tareas de MCP Shrimp
- ✨ Características
- 🧭 Guía de uso
- 🔬 Modo de investigación
- Función de memoria de tareas
- 📋 Inicialización de las reglas del proyecto
- Recursos de documentación
- 🔧 Instalación y uso
- 🔌 Uso con clientes compatibles con MCP
- 💡 Guía de indicaciones del sistema
- 🛠️ Descripción general de las herramientas disponibles
- 🔧 Implementación técnica
- 📄 Licencia
- Modelos recomendados
- Historia de las estrellas
Related MCP Servers
- -securityAlicense-qualityAn MCP server that converts Cursor agent plans into structured markdown task lists and organizes them in your repository, helping you track AI-generated plans and recommendations as actionable specifications.Last updated -3PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants to interact with Linear project management systems, allowing users to retrieve, create, and update issues, projects, and teams through natural language.Last updated -32805TypeScriptMIT License
- -securityAlicense-qualityAI-driven task management application that operates via MCP, enabling autonomous creation, organization, and execution of tasks with support for subtasks, priorities, and progress tracking.Last updated -PythonMIT License
- AsecurityFlicenseAqualityAn MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.Last updated -1137TypeScript