veyra-tasks

Una herramienta MCP de gestión de tareas persistente para agentes de IA, con agrupación por proyectos, prioridades y seguimiento de estado. Las lecturas son siempre gratuitas. Las operaciones de escritura requieren autorización del modo de confirmación de Veyra.

Descripción general

veyra-tasks proporciona a los agentes de IA una capa de gestión de tareas fiable respaldada por SQLite. Los agentes pueden listar e inspeccionar tareas libremente. La creación, actualización, finalización y eliminación de tareas está protegida por el modo de confirmación de Veyra, lo que garantiza escrituras intencionadas y responsables.

Instalación

npm install
npm run build

Las tareas se almacenan en ~/.veyra-tasks/data.db, que se crea automáticamente en la primera ejecución.

Configuración de MCP (Claude Desktop)

Añada lo siguiente a su claude_desktop_config.json:

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

Herramientas

Valores de estado

todo · in_progress · done

Valores de prioridad

low · medium · high · urgent

Ejemplos

Lectura (no se necesita token)

// 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" } }

Escritura (se requiere token de Veyra)

// 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_..."
  }
}

Respuesta de error cuando falta el 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"
}

Cómo funciona Veyra

Veyra es una capa de autorización de modo de confirmación para agentes de IA. Cuando un agente intenta una operación de escritura:

1. El agente llama a la herramienta sin un veyra_token y recibe un error VeyraCommitRequired con un authorize_endpoint.

2. El agente (o el usuario en su nombre) llama al punto final de autorización para obtener un token.

3. El agente vuelve a intentar la llamada a la herramienta con el veyra_token configurado.

4. veyra-tasks verifica el token a través de @veyrahq/sdk-node antes de ejecutar la escritura.

Consulte veyra.to para obtener la documentación completa.

Licencia

MIT