DeltaTask

DeltaTask - Sistema Avançado de Gerenciamento de Tarefas

Um poderoso aplicativo de gerenciamento de tarefas hospedado localmente, com integração com Obsidian e um servidor Model Context Protocol (MCP).

Recursos

• Gerenciamento Inteligente de Tarefas: Crie tarefas com níveis de urgência e estimativas de esforço
• Mecanismo de Priorização: Classifica automaticamente as tarefas por urgência e esforço
• Decomposição de Tarefas: Divida tarefas maiores em subtarefas gerenciáveis
• Sistema de Etiquetas: Organize tarefas com etiquetas personalizadas
• Armazenamento Local: Todos os dados armazenados localmente em banco de dados SQLite
• Integração com Obsidian: Sincronização bidirecional com arquivos markdown do Obsidian
• Servidor MCP: Acesso completo à API através do Model Context Protocol

Detalhes Técnicos

Modelo de Dados

• Tarefas: Entidade central de tarefas com propriedades:
  • Título e descrição
  • Urgência (escala de 1 a 5, sendo 5 o mais alto)
  • Esforço (escala de 1 a 21, seguindo a sequência de Fibonacci)
  • Status de conclusão
  • Relacionamentos pai-filho para subtarefas
  • Etiquetas para categorização

Esquema do Banco de Dados

O aplicativo usa SQLite com as seguintes tabelas:

• todos: Armazena todos os itens de tarefa e suas propriedades
• tags: Armazena nomes de etiquetas únicos
• todo_tags: Tabela de junção para relacionamento muitos-para-muitos entre tarefas e etiquetas

Integração com Obsidian

O DeltaTask cria e mantém um vault estruturado do Obsidian:

• Arquivos de tarefa com metadados frontmatter
• Visualizações baseadas em etiquetas para filtrar tarefas
• Painel de estatísticas
• Sincronização bidirecional entre markdown do Obsidian e banco de dados SQLite

Endpoints da API MCP

O servidor MCP expõe as seguintes operações:

• get_task_by_id: Obter uma tarefa específica por ID
• search_tasks: Encontrar tarefas por título, descrição ou etiquetas
• create_task: Criar uma nova tarefa
• update_task: Atualizar as propriedades de uma tarefa
• delete_task: Remover uma tarefa
• sync_tasks: Sincronizar tarefas do markdown do Obsidian para o SQLite
• list_tasks: Listar todas as tarefas
• get_statistics: Recuperar métricas sobre tarefas
• create_subtasks: Dividir uma tarefa em múltiplas subtarefas
• get_all_tags: Obter todos os nomes de etiquetas únicos
• get_subtasks: Obter subtarefas para uma tarefa pai específica
• finish_task: Marcar uma tarefa como concluída

Começando

Pré-requisitos

• Python 3.10+
• SQLite3
• Obsidian (opcional, para integração com markdown)

Instalação

1. Clone este repositório

2. Configure o ambiente Python usando uv:

   # Create and activate the virtual environment
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   
   # Install dependencies
   uv pip install -r requirements.txt
   

Executando o Servidor MCP

O servidor MCP do DeltaTask pode ser usado com o Claude for Desktop:

1. Configure o Claude for Desktop:

   • Abra ou crie ~/Library/Application Support/Claude/claude_desktop_config.json
   • Adicione a configuração do servidor DeltaTask:

   {
     "mcpServers": {
       "deltatask": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/DeltaTask",
           "run",
           "server.py"
         ]
       }
     }
   }
   

   • Reinicie o Claude for Desktop

Se você encontrar problemas ou quiser mais detalhes, consulte a Documentação do MCP.

Por exemplo, na documentação:

Talvez seja necessário colocar o caminho completo para o executável uv no campo command. Você pode obter isso executando which uv no MacOS/Linux ou where uv no Windows.

2. Use as ferramentas do DeltaTask no Claude for Desktop clicando no ícone de martelo

Model Context Protocol (MCP)

Este aplicativo implementa uma abordagem Model Context Protocol para gerenciamento de tarefas:

1. Modelo de Dados Estruturado: Esquema claramente definido para tarefas com relacionamentos
2. Cálculo de Prioridade: Classificação inteligente baseada em múltiplos fatores
3. Organização Hierárquica: Relacionamentos pai-filho para decomposição de tarefas
4. Sistema de Etiquetas: Categorização flexível para melhor contexto
5. Estatísticas e Insights: Agregação de dados para compreender padrões de tarefas
6. Integração com Obsidian: Visualização e edição baseadas em Markdown

Licença

Licença MIT