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 mediante el 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.

Related MCP server: Cold's MCP Server - Project Management System

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 de conexión 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

Paquete alojado (recomendado)

Prefiera el paquete alojado para una integración mediante una sola URL:

{
  "mcpServers": {
    "veyra": {
      "url": "https://mcp.veyra.to/sse"
    }
  }
}

Una URL. 48 herramientas. 24 lecturas gratuitas. 24 escrituras protegidas.

Paquete alojado: https://mcp.veyra.to/sse

Manifiesto del paquete: https://mcp.veyra.to/.well-known/veyra-pack.json

Utilice el paquete alojado cuando desee la ruta de integración MCP más rápida en todas las familias de herramientas de Veyra. Utilice este paquete independiente cuando desee específicamente esta herramienta por sí sola.

Parte del ecosistema Veyra

Veyra es el modo de confirmación para las acciones de agentes de IA en producción. Todas las herramientas: lecturas gratuitas, las escrituras requieren el modo de confirmación de Veyra.

SDK: npm install @veyrahq/sdk-node Sitio web: veyra.to