Shrimp Task Manager

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.

Inglés | Chino

目錄

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

🔧 Instalación y uso

Instalación mediante herrería

Para instalar Shrimp Task Manager para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @cjo4m06/mcp-shrimp-task-manager --client claude

Instalación manual

# Install dependencies npm install # Build and start service npm run build

🔌 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
  1. Abra el archivo de configuración global de Cursor IDE (generalmente ubicado en ~/.cursor/mcp.json )
  2. Agregue la siguiente configuración en la sección mcpServers :
{ "mcpServers": { "shrimp-task-manager": { "command": "node", "args": ["/mcp-shrimp-task-manager/dist/index.js"], "env": { "DATA_DIR": "/path/to/project/data" // 必須使用絕對路徑 } } } } or { "mcpServers": { "shrimp-task-manager": { "command": "npx", "args": ["-y", "mcp-shrimp-task-manager"], "env": { "DATA_DIR": "/mcp-shrimp-task-manager/data" } } } }

⚠️ 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:

  1. Cree un directorio .cursor en la raíz del proyecto
  2. Cree un archivo mcp.json en este directorio con el siguiente contenido:
{ "mcpServers": { "shrimp-task-manager": { "command": "node", "args": ["/path/to/mcp-shrimp-task-manager/dist/index.js"], "env": { "DATA_DIR": "/path/to/project/data" // Must use absolute path } } } } or { "mcpServers": { "shrimp-task-manager": { "command": "npx", "args": ["-y", "mcp-shrimp-task-manager"], "env": { "DATA_DIR": "/path/to/project/data" // 必須使用絕對路徑 } } } }

⚠️ 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 :

{ "mcpServers": { "shrimp-task-manager": { "command": "node", "args": ["/path/to/mcp-shrimp-task-manager/dist/index.js"], "env": { "DATA_DIR": "/path/to/project/data", "MCP_PROMPT_PLAN_TASK": "Custom planning guidance...", "MCP_PROMPT_EXECUTE_TASK_APPEND": "Additional execution instructions...", "ENABLE_THOUGHT_CHAIN": "true", "TEMPLATES_USE": "en" } } } }

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 herramienta process_thought para el razonamiento paso a paso. Cuando se establece en false , el sistema usa directamente analyze_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 son en y zh . Para usar plantillas personalizadas, copie el directorio src/prompts/templates_en a la ubicación especificada por DATA_DIR , cambie el nombre del directorio copiado (p. ej., a my_templates ) y configure TEMPLATES_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
You are a professional task planning expert. You must interact with users, analyze their needs, and collect project-related information. Finally, you must use "plan_task" to create tasks. When the task is created, you must summarize it and inform the user to use the "TaskExecutor" mode to execute the task. You must focus on task planning. Do not use "execute_task" to execute tasks. Serious warning: you are a task planning expert, you cannot modify the program code directly, you can only plan tasks, and you cannot modify the program code directly, you can only plan tasks.
Modo TaskExecutor
You are a professional task execution expert. When a user specifies a task to execute, use "execute_task" to execute the task. If no task is specified, use "list_tasks" to find unexecuted tasks and execute them. When the execution is completed, a summary must be given to inform the user of the conclusion. You can only perform one task at a time, and when a task is completed, you are prohibited from performing the next task unless the user explicitly tells you to. If the user requests "continuous mode", all tasks will be executed in sequence.

💡 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: ...... o Please start executing the task...

🛠️ Descripción general de las herramientas disponibles

Después de la configuración, puede utilizar las siguientes herramientas:

CategoríaNombre de la herramientaDescripción
Planificación de tareasplan_taskComience a planificar tareas
Análisis de tareasanalyze_taskAnálisis en profundidad de los requisitos de la tarea
process_thoughtRazonamiento paso a paso para problemas complejos
Evaluación de la soluciónreflect_taskReflexionar y mejorar los conceptos de solución
Gestión de proyectosinit_project_rulesInicializar o actualizar los estándares y reglas del proyecto
Gestión de tareassplit_tasksDividir las tareas en subtareas
list_tasksMostrar todas las tareas y estados
query_taskBuscar y enumerar tareas
get_task_detailMostrar detalles completos de la tarea
delete_taskEliminar tareas incompletas
Ejecución de tareasexecute_taskEjecutar tareas específicas
verify_taskVerificar la finalización de la tarea
complete_taskMarcar 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.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

  1. MCP Shrimp Task Manager
    1. ✨ <a id="features1"></a>Features
    2. 🧭 <a id="usage-guide"></a>Usage Guide
    3. 🧠 <a id="task-memory-function"></a>Task Memory Function
    4. 🤔 <a id="thought-chain"></a>Thought Chain Process
    5. 📋 <a id="project-rules"></a>Project Rules Initialization
    6. 📚 <a id="documentation"></a>Documentation Resources
    7. 🔧 <a id="installation"></a>Installation and Usage
    8. 🔌 <a id="clients"></a>Using with MCP-Compatible Clients
    9. 💡 <a id="prompt"></a>System Prompt Guidance
    10. 🛠️ <a id="tools"></a>Available Tools Overview
    11. 🔧 Technical Implementation
    12. 📄 <a id="license"></a>License
    13. <a id="recommended"></a>Recommended Models
    14. Star History

Related MCP Servers

  • -
    security
    F
    license
    -
    quality
    An 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 -
    2
    TypeScript
  • -
    security
    A
    license
    -
    quality
    AI-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 -
    Python
    MIT License
    • Linux
  • A
    security
    A
    license
    A
    quality
    An 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 -
    11
    6
    TypeScript
    MIT License
    • Linux
    • Apple
  • -
    security
    -
    license
    -
    quality
    An 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 -
    1
    Python
    MIT License

View all related MCP servers

ID: buebie25qp