DeltaTask MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Supports markdown-based visualization and editing through the Obsidian integration

  • Provides bi-directional sync between Obsidian markdown files and the task database, creating and maintaining a structured Obsidian vault with task files, tag-based views, and statistics dashboard

  • Uses SQLite as the database backend for storing all task data in tables for todos, tags, and todo_tags relationships

DeltaTask - Sistema avanzado de gestión de tareas

Una potente aplicación de gestión de tareas alojada localmente con integración con Obsidian y un servidor de Protocolo de Contexto de Modelo (MCP).

Características

  • Gestión inteligente de tareas : crea tareas con niveles de urgencia y estimaciones de esfuerzo
  • Motor de priorización : clasifica automáticamente las tareas por urgencia y esfuerzo
  • Descomposición de tareas : divida las tareas más grandes en subtareas manejables
  • Sistema de etiquetado : organice tareas con etiquetas personalizadas
  • Almacenamiento local : todos los datos se almacenan localmente en la base de datos SQLite
  • Integración con Obsidian : sincronización bidireccional con archivos Markdown de Obsidian
  • Servidor MCP : acceso completo a la API a través del Protocolo de contexto de modelo

Detalles técnicos

Modelo de datos

  • Tareas : Entidad de tarea principal con propiedades:
    • Título y descripción
    • Urgencia (escala del 1 al 5, siendo 5 la más alta)
    • Esfuerzo (escala 1-21, siguiendo la secuencia de Fibonacci)
    • Estado de finalización
    • Relaciones padre-hijo para subtareas
    • Etiquetas para categorización

Esquema de base de datos

La aplicación utiliza SQLite con las siguientes tablas:

  • todos : almacena todos los elementos de la tarea y sus propiedades
  • tags : almacena nombres de etiquetas únicos
  • todo_tags : Tabla de unión para la relación de muchos a muchos entre tareas y etiquetas

Integración de obsidiana

DeltaTask crea y mantiene una bóveda de Obsidian estructurada:

  • Archivos de tareas con metadatos de portada
  • Vistas basadas en etiquetas para filtrar tareas
  • Panel de estadísticas
  • Sincronización bidireccional entre Markdown de Obsidian y la base de datos SQLite

Puntos finales de la API de MCP

El servidor MCP expone las siguientes operaciones:

  • get_task_by_id : Obtener una tarea específica por ID
  • search_tasks : busca tareas por título, descripción o etiquetas
  • create_task : Crea una nueva tarea
  • update_task : Actualizar las propiedades de una tarea
  • delete_task : Eliminar una tarea
  • sync_tasks : Sincroniza tareas desde Obsidian Markdown a SQLite
  • list_tasks : Listar todas las tareas
  • get_statistics : recupera métricas sobre las tareas
  • create_subtasks : Divide una tarea en múltiples subtareas
  • get_all_tags : Obtener todos los nombres de etiquetas únicos
  • get_subtasks : Obtener subtareas para una tarea principal determinada
  • finish_task : Marcar una tarea como completada

Empezando

Prerrequisitos

  • Python 3.10+
  • SQLite3
  • Obsidian (opcional, para integración de rebajas)

Instalación

  1. Clonar este repositorio
  2. Configurar el entorno de 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

Ejecución del servidor MCP

El servidor DeltaTask MCP se puede utilizar con Claude for Desktop:

  1. Configurar Claude para escritorio:
    • Abra o cree ~/Library/Application Support/Claude/claude_desktop_config.json
    • Agregue la configuración del servidor DeltaTask:
    { "mcpServers": { "deltatask": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/DeltaTask", "run", "server.py" ] } } }
    • Reiniciar Claude para escritorio

Si tiene problemas o desea más detalles, consulte la documentación del MCP .

Por ejemplo, de los documentos:

Es posible que necesites introducir la ruta completa del ejecutable uv en el campo command . Puedes obtenerla ejecutando which uv en macOS/Linux o where uv en Windows.

  1. Utilice las herramientas DeltaTask en Claude for Desktop haciendo clic en el ícono del martillo

Protocolo de Contexto Modelo (MCP)

Esta aplicación implementa un enfoque de Protocolo de Contexto de Modelo para la gestión de tareas:

  1. Modelo de datos estructurado : esquema claramente definido para tareas con relaciones
  2. Cálculo de prioridad : clasificación inteligente basada en múltiples factores
  3. Organización jerárquica : relaciones padre-hijo para la descomposición de tareas
  4. Sistema de etiquetado : categorización flexible para un mejor contexto
  5. Estadísticas y perspectivas : agregación de datos para comprender patrones de tareas
  6. Integración con Obsidian : visualización y edición basadas en Markdown

Licencia

Licencia MIT

You must be authenticated.

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

Proporciona acceso API a un sistema de gestión de tareas alojado localmente con funciones para crear, actualizar y organizar tareas, incluido soporte para niveles de urgencia, estimaciones de esfuerzo, subtareas y sincronización bidireccional con archivos Markdown de Obsidian.

  1. Features
    1. Technical Details
      1. Data Model
      2. Database Schema
      3. Obsidian Integration
      4. MCP API Endpoints
    2. Getting Started
      1. Prerequisites
      2. Installation
      3. Running the MCP Server
    3. Model Context Protocol (MCP)
      1. License

        Appeared in Searches

        ID: tsroe1zvk4