Integrations
Supports configuration through environment variables, allowing customization of prompts and system behavior without modifying code.
Leverages Node.js as the runtime environment for the task management system, enabling efficient execution of the MCP server and its task management capabilities.
Uses TypeScript to provide a type-safe development environment for the task management system, enhancing code reliability and maintainability.
目錄
- ✨ Características
- 🧭 Guía de uso
- Función de memoria de tareas
- Proceso de cadena de pensamiento
- 📋 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
- 📄 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.
- Proceso de cadena de pensamiento : razonamiento paso a paso para analizar sistemáticamente problemas complejos
- Inicialización de reglas del proyecto : definir estándares y reglas del proyecto para mantener la coherencia en proyectos grandes
🧭 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.
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.
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.
Proceso de cadena de pensamiento
La función Cadena de Pensamiento mejora la resolución de problemas a través del pensamiento estructurado:
- Razonamiento sistemático : dividir problemas complejos en pasos lógicos
- Prueba de suposiciones : cuestionar suposiciones para validar enfoques de solución
- Análisis crítico : evaluar opciones de solución con criterios rigurosos
- Toma de decisiones mejorada : llegue a conclusiones más confiables mediante el pensamiento deliberado
Cuando está habilitado (configuración predeterminada), el sistema guía al Agente a través del razonamiento paso a paso utilizando la herramienta process_thought
, lo que garantiza un análisis exhaustivo del problema antes de la implementación.
📋 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
- Arquitectura del sistema : Diseño detallado del sistema y explicación del flujo de datos
- 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
- ENABLE_THOUGHT_CHAIN : Controla el modelo de pensamiento en el flujo de trabajo de planificación de tareas. Cuando se establece en
true
(valor predeterminado), el sistema guía a los usuarios para usar la herramientaprocess_thought
para el razonamiento paso a paso. Cuando se establece enfalse
, el sistema usa directamenteanalyze_task
para enviar los resultados del análisis, omitiendo el proceso de pensamiento detallado. - 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 |
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 | |
complete_task | Marcar tareas como completadas |
🔧 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.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
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.
- MCP Shrimp Task Manager
- ✨ <a id="features1"></a>Features
- 🧭 <a id="usage-guide"></a>Usage Guide
- 🧠 <a id="task-memory-function"></a>Task Memory Function
- 🤔 <a id="thought-chain"></a>Thought Chain Process
- 📋 <a id="project-rules"></a>Project Rules Initialization
- 📚 <a id="documentation"></a>Documentation Resources
- 🔧 <a id="installation"></a>Installation and Usage
- 🔌 <a id="clients"></a>Using with MCP-Compatible Clients
- 💡 <a id="prompt"></a>System Prompt Guidance
- 🛠️ <a id="tools"></a>Available Tools Overview
- 🔧 Technical Implementation
- 📄 <a id="license"></a>License
- <a id="recommended"></a>Recommended Models
- Star History
Related MCP Servers
- -securityFlicense-qualityAn MCP server that enables AI agents to interact with Atlassian products (Confluence and Jira) for content management, issue tracking, and project management through a standardized interface.Last updated -2TypeScript
- -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
- AsecurityAlicenseAqualityAn 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 -116TypeScriptMIT License
- -security-license-qualityAn MCP server that provides a "think" tool enabling structured reasoning for AI agents, allowing them to pause and record explicit thoughts during complex tasks or multi-step tool use.Last updated -1PythonMIT License