Todo List

Un servidor que proporciona una API completa para gestionar elementos de la lista de tareas.

GitHub
46

Documentación

Servidor MCP de Lista de Tareas

Un servidor de Model Context Protocol (MCP) que proporciona una API completa para gestionar elementos de tareas pendientes.

Todo List Server MCP server

📚 Recurso de Aprendizaje: Este proyecto está diseñado como un ejemplo educativo de implementación de MCP. Consulta GUIDE.md para obtener una explicación completa de cómo funciona el proyecto y por qué las cosas están implementadas de la manera en que lo están.

Características

  • Crear tareas: Añade nuevas tareas con título y descripción en markdown
  • Actualizar tareas: Modifica tareas existentes
  • Completar tareas: Marca tareas como finalizadas
  • Eliminar tareas: Elimina tareas de la lista
  • Buscar tareas: Encuentra tareas por título o fecha de creación
  • Resumir tareas: Obtén una visión general rápida de las tareas activas

Herramientas

Este servidor MCP expone las siguientes herramientas:

  1. create-todo: Crea un nuevo elemento de tarea
  2. list-todos: Lista todas las tareas
  3. get-todo: Obtiene una tarea específica por ID
  4. update-todo: Actualiza el título o la descripción de una tarea
  5. complete-todo: Marca una tarea como completada
  6. delete-todo: Elimina una tarea
  7. search-todos-by-title: Busca tareas por título (coincidencia parcial sin distinción de mayúsculas)
  8. search-todos-by-date: Busca tareas por fecha de creación (formato: YYYY-MM-DD)
  9. list-active-todos: Lista todas las tareas no completadas
  10. summarize-active-todos: Genera un resumen de todas las tareas activas (no completadas)

Instalación

# Clone the repository
git clone https://github.com/RegiByte/todo-list-mcp.git
cd todo-list-mcp

# Install dependencies
npm install

# Build the project
npm run build

Uso

Iniciando el Servidor

npm start

Configuración con Claude for Desktop

Claude Desktop

Añade esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/absolute/path/to/todo-list-mcp/dist/index.js"]
    }
  }
}

Cursor

  • Ve a "Cursor Settings" -> MCP
  • Añade un nuevo servidor MCP con tipo "command"
  • Añade la ruta absoluta del servidor y ejecútalo con node
  • Ejemplo: node /absolute/path/to/todo-list-mcp/dist/index.js

Comandos de Ejemplo

Cuando lo uses con Claude for Desktop o Cursor, puedes probar:

  • "Crea una tarea para aprender MCP con una descripción que explique por qué MCP es útil"
  • "Lista todas mis tareas activas"
  • "Crea una tarea para la reunión de mañana con detalles sobre la agenda en markdown"
  • "Marca mi tarea de aprendizaje de MCP como completada"
  • "Resume todas mis tareas activas"

Estructura del Proyecto

Este proyecto sigue una clara separación de responsabilidades para que el código sea fácil de entender:

src/
├── models/       # Data structures and validation schemas
├── services/     # Business logic and database operations
├── utils/        # Helper functions and formatters
├── config.ts     # Configuration settings
├── client.ts     # Test client for local testing
└── index.ts      # Main entry point with MCP tool definitions

Aprendiendo de Este Proyecto

Este proyecto está diseñado como un recurso educativo. Para aprovecharlo al máximo:

  1. Lee el GUIDE.md para obtener una explicación completa del diseño
  2. Estudia el código fuente con comentarios detallados para entender los detalles de implementación
  3. Usa el cliente de prueba para ver cómo funciona el servidor en la práctica
  4. Experimenta añadiendo tus propias herramientas o ampliando las existentes

Desarrollo

Compilación

npm run build

Ejecución en Modo de Desarrollo

npm run dev

Licencia

MIT