Todo List

Um servidor que fornece uma API abrangente para gerenciar itens de tarefas.

GitHub
46

Documentação

Servidor MCP Todo List

Um servidor Model Context Protocol (MCP) que fornece uma API abrangente para gerenciar itens de tarefas.

Todo List Server MCP server

📚 Recurso de Aprendizado: Este projeto foi projetado como um exemplo educacional de implementação de MCP. Consulte GUIDE.md para uma explicação abrangente de como o projeto funciona e por que as coisas são implementadas da maneira que são.

Recursos

  • Criar tarefas: Adicione novas tarefas com título e descrição em markdown
  • Atualizar tarefas: Modifique tarefas existentes
  • Concluir tarefas: Marque tarefas como concluídas
  • Excluir tarefas: Remova tarefas da lista
  • Pesquisar tarefas: Encontre tarefas por título ou data de criação
  • Resumir tarefas: Obtenha uma visão geral rápida das tarefas ativas

Ferramentas

Este servidor MCP expõe as seguintes ferramentas:

  1. create-todo: Crie um novo item de tarefa
  2. list-todos: Liste todas as tarefas
  3. get-todo: Obtenha uma tarefa específica por ID
  4. update-todo: Atualize o título ou a descrição de uma tarefa
  5. complete-todo: Marque uma tarefa como concluída
  6. delete-todo: Exclua uma tarefa
  7. search-todos-by-title: Pesquise tarefas por título (correspondência parcial sem diferenciar maiúsculas de minúsculas)
  8. search-todos-by-date: Pesquise tarefas por data de criação (formato: AAAA-MM-DD)
  9. list-active-todos: Liste todas as tarefas não concluídas
  10. summarize-active-todos: Gere um resumo de todas as tarefas ativas (não concluídas)

Instalação

# 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 o Servidor

npm start

Configurando com Claude for Desktop

Claude Desktop

Adicione isso ao seu claude_desktop_config.json:

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

Cursor

  • Vá para "Cursor Settings" -> MCP
  • Adicione um novo servidor MCP com um tipo "command"
  • Adicione o caminho absoluto do servidor e execute-o com node
  • Exemplo: node /absolute/path/to/todo-list-mcp/dist/index.js

Exemplos de Comandos

Ao usar com Claude for Desktop ou Cursor, você pode tentar:

  • "Crie uma tarefa para aprender MCP com uma descrição explicando por que o MCP é útil"
  • "Liste todas as minhas tarefas ativas"
  • "Crie uma tarefa para a reunião de amanhã com detalhes sobre a pauta em markdown"
  • "Marque minha tarefa de aprendizado de MCP como concluída"
  • "Resuma todas as minhas tarefas ativas"

Estrutura do Projeto

Este projeto segue uma separação clara de responsabilidades para tornar o código 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

Aprendendo com Este Projeto

Este projeto foi projetado como um recurso educacional. Para aproveitá-lo ao máximo:

  1. Leia o GUIDE.md para uma explicação abrangente do design
  2. Estude o código-fonte amplamente comentado para entender os detalhes de implementação
  3. Use o cliente de teste para ver como o servidor funciona na prática
  4. Experimente adicionar suas próprias ferramentas ou estender as existentes

Desenvolvimento

Compilação

npm run build

Executando em Modo de Desenvolvimento

npm run dev

Licença

MIT