Todo List MCP Server

by RegiByte
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Lista de tareas pendientes del servidor MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una API integral para administrar elementos de tareas pendientes.

Recurso de aprendizaje : Este proyecto está diseñado como un ejemplo educativo de la implementación de MCP. Consulte GUIDE.md para obtener una explicación completa de cómo funciona el proyecto y por qué se implementa de la forma en que se hace.

Características

  • Crear tareas pendientes : agregar nuevas tareas con título y descripción de Markdown
  • Actualizar todos : modificar tareas existentes
  • Completar tareas : marcar tareas como realizadas
  • Eliminar todos : eliminar tareas de la lista
  • Buscar todos : Encuentra tareas por título o fecha de creación
  • Resumir tareas pendientes : obtenga una descripció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 pendiente
  2. list-todos : Listar todos los tareas pendientes
  3. get-todo : Obtener una tarea específica por ID
  4. update-todo : Actualizar el título o la descripción de una tarea
  5. complete-todo : marcar una tarea como completada
  6. delete-todo : Eliminar una tarea pendiente
  7. search-todos-by-title : Buscar todos por título (coincidencia parcial sin distinguir entre mayúsculas y minúsculas)
  8. search-todos-by-date : busca todos por fecha de creación (formato: AAAA-MM-DD)
  9. list-active-todos : Lista todas las tareas pendientes no completadas
  10. summarize-active-todos : Generar 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 para escritorio

Escritorio de Claude

Agregue esto a su claude_desktop_config.json :

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

Cursor

  • Vaya a "Configuración del cursor" -> MCP
  • Agregue un nuevo servidor MCP con un tipo "comando"
  • Agregue la ruta absoluta del servidor y ejecútelo con el nodo
  • Ejemplo: nodo /ruta/absoluta/a/lista-de-todos-mcp/dist/index.js

Comandos de ejemplo

Al utilizar Claude para escritorio o cursor, puedes probar:

  • "Crea una tarea para aprender MCP con una descripción que explique por qué es útil".
  • "Enumerar todas mis tareas activas"
  • Crea una tarea para la reunión de mañana con detalles de la agenda en formato Markdown.
  • Marcar mi tarea de aprendizaje MCP como completada
  • "Resumir todas mis tareas activas"

Estructura del proyecto

Este proyecto sigue una clara separación de preocupaciones 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 recurso educativo. Para aprovecharlo al máximo:

  1. Lea GUIDE.md para obtener una explicación completa del diseño.
  2. Estudie el código fuente profusamente comentado para comprender los detalles de implementación.
  3. Utilice el cliente de prueba para ver cómo funciona el servidor en la práctica
  4. Experimente añadiendo sus propias herramientas o ampliando las existentes

Desarrollo

Edificio

npm run build

Ejecutando en modo de desarrollo

npm run dev

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

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

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para administrar elementos de tareas pendientes, incluidas la creación, actualización, finalización, eliminación, búsqueda y resumen de tareas.

  1. Features
    1. Tools
      1. Installation
        1. Usage
          1. Starting the Server
          2. Configuring with Claude for Desktop
          3. Example Commands
        2. Project Structure
          1. Learning from This Project
            1. Development
              1. Building
              2. Running in Development Mode
            2. License
              ID: kh39rjpplx