Lista de verificación TODO de MCP

Un servidor MCP que implementa un sistema de lista de verificación para la gestión de tareas en Claude Desktop. El sistema permite crear y administrar múltiples listas de tareas, con soporte para prioridades, fechas de vencimiento y etiquetas.

Características

✅ Crear y gestionar múltiples listas de tareas pendientes
📌 Soporte prioritario (bajo, medio, alto)
📅 Fechas de vencimiento de las tareas
🏷️ Sistema de etiquetas para organización
👥 Compartir listas entre usuarios
Almacenamiento persistente del sistema de archivos

Requisitos

Node.js 18 o superior
NPM 8 o superior

Instalación

Método 1: Instalación local (desarrollo)

Clonar el repositorio

cd C:\workspace\mcp
git clone (seu-repositório) mcp-mr-checklist
cd mcp-mr-checklist

Instalar dependencias y compilar

npm install
npm run build

Configurar en claude_desktop_config.json :

{
  "servers": {
    "todo-checklist": {
      "type": "command",
      "command": "node dist/index.js",
      "cwd": "C:\\workspace\\mcp\\mcp-mr-checklist",
      "config": {
        "storagePath": "./data",
        "commandTimeout": 60000
      }
    }
  }
}

Método 2: Instalación global (Uso)

Instalar el paquete globalmente

npm install -g @hevener/server-todo-checklist

Configurar en claude_desktop_config.json :

{
  "servers": {
    "todo-checklist": {
      "type": "command",
      "command": "mcp-server-todo-checklist",
      "config": {
        "storagePath": "C:\\Users\\SEU_USUARIO\\AppData\\Local\\claude-todo-checklist",
        "commandTimeout": 60000
      }
    }
  }
}

Comandos disponibles en Claude

Crear una nueva lista

/todo_create {
  "title": "Minha Lista",
  "description": "Descrição opcional da lista"
}

Agregar una tarea

/todo_add {
  "listTitle": "Minha Lista",
  "taskTitle": "Nova Tarefa",
  "priority": "high",
  "dueDate": "2024-01-20",
  "tags": ["trabalho", "urgente"]
}

Listar todas las listas

/todo_list

Ver detalles de una lista

/todo_show {
  "listTitle": "Minha Lista"
}

Marcar la tarea como completada

/todo_complete {
  "listTitle": "Minha Lista",
  "taskTitle": "Nova Tarefa"
}

Estructura del proyecto

src/
├── index.ts           # Ponto de entrada do servidor
├── commands.ts        # Definição dos comandos disponíveis
├── service/          
│   └── ChecklistService.ts  # Lógica de negócio
├── storage/
│   └── index.ts      # Implementação do armazenamento
└── types/
    ├── ChecklistItem.ts     # Tipos para itens
    └── index.ts            # Tipos principais

Estructura de datos

Lista de verificación

interface Checklist {
  id: string;
  title: string;
  description?: string;
  items: ChecklistItem[];
  owner: string;
  shared?: string[];
  createdAt: Date;
  updatedAt: Date;
}

Tarea (Elemento de lista de verificación)

interface ChecklistItem {
  id: string;
  title: string;
  description?: string;
  completed: boolean;
  dueDate?: Date;
  priority: 'low' | 'medium' | 'high';
  tags: string[];
  createdAt: Date;
  updatedAt: Date;
}

Scripts de desarrollo

# Compilar o projeto
npm run build

# Executar em modo desenvolvimento
npm run dev

# Observar alterações e recompilar
npm run watch

# Iniciar o servidor compilado
npm start

Ajustes

En el archivo claude_desktop_config.json , puedes configurar:

storagePath : Directorio donde se almacenarán los datos
commandTimeout : Tiempo máximo de ejecución del comando en milisegundos (predeterminado: 60000)

Tecnologías utilizadas

Mecanografiado
SDK de protocolo de contexto de modelo
Zod (validación de datos)
Sistema de almacenamiento basado en archivos

Licencia

Distribuido bajo la licencia MIT. Consulte LICENSE para obtener más información.

MCP TODO Checklist Server