veyra-tasks

Ein persistentes MCP-Tool zur Aufgabenverwaltung für KI-Agenten mit Projektgruppierung, Prioritäten und Statusverfolgung. Lesezugriffe sind immer kostenlos. Schreibvorgänge erfordern eine Autorisierung über den Veyra Commit-Modus.

Übersicht

veyra-tasks bietet KI-Agenten eine zuverlässige Ebene zur Aufgabenverwaltung, die auf SQLite basiert. Agenten können Aufgaben frei auflisten und einsehen. Das Erstellen, Aktualisieren, Abschließen und Löschen von Aufgaben ist durch den Veyra-Commit-Modus geschützt – dies stellt bewusste und nachvollziehbare Schreibvorgänge sicher.

Installation

npm install
npm run build

Aufgaben werden unter ~/.veyra-tasks/data.db gespeichert und beim ersten Start automatisch erstellt.

MCP-Konfiguration (Claude Desktop)

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

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

Tools

Statuswerte

todo · in_progress · done

Prioritätswerte

low · medium · high · urgent

Beispiele

Lesen (kein Token erforderlich)

// List all tasks
{ "tool": "list_tasks", "arguments": {} }

// List in-progress tasks for a project
{ "tool": "list_tasks", "arguments": { "status": "in_progress", "project": "website" } }

// List urgent tasks
{ "tool": "list_tasks", "arguments": { "priority": "urgent" } }

// Get a specific task
{ "tool": "get_task", "arguments": { "id": "1712345678-abc1234" } }

Schreiben (Veyra-Token erforderlich)

// Create a task
{
  "tool": "create_task",
  "arguments": {
    "title": "Fix login bug",
    "description": "Users cannot log in on mobile Safari",
    "priority": "urgent",
    "project": "website",
    "due": "2025-04-20",
    "veyra_token": "vt_..."
  }
}

// Update task status
{
  "tool": "update_task",
  "arguments": {
    "id": "1712345678-abc1234",
    "status": "in_progress",
    "veyra_token": "vt_..."
  }
}

// Mark a task done
{
  "tool": "complete_task",
  "arguments": {
    "id": "1712345678-abc1234",
    "veyra_token": "vt_..."
  }
}

// Delete a task
{
  "tool": "delete_task",
  "arguments": {
    "id": "1712345678-abc1234",
    "veyra_token": "vt_..."
  }
}

Fehlerantwort bei fehlendem Token

{
  "error": "VeyraCommitRequired",
  "message": "Write operations require Veyra commit mode.",
  "currentMode": "open",
  "requiredMode": "commit",
  "transitionStrategy": "authorize_then_retry_with_x_veyra_token",
  "provider": "veyra",
  "authorize_endpoint": "https://api.veyra.to/v1/authorize-action",
  "docs_url": "https://veyra.to"
}

Funktionsweise von Veyra

Veyra ist eine Autorisierungsebene für den Commit-Modus bei KI-Agenten. Wenn ein Agent einen Schreibvorgang versucht:

1. Der Agent ruft das Tool ohne veyra_token auf und erhält einen VeyraCommitRequired-Fehler mit einem authorize_endpoint.

2. Der Agent (oder der Benutzer in seinem Namen) ruft den Autorisierungs-Endpunkt auf, um ein Token zu erhalten.

3. Der Agent wiederholt den Tool-Aufruf mit gesetztem veyra_token.

4. veyra-tasks verifiziert das Token über @veyrahq/sdk-node, bevor der Schreibvorgang ausgeführt wird.

Weitere Informationen finden Sie unter veyra.to in der vollständigen Dokumentation.

Lizenz

MIT