veyra-tasks

프로젝트 그룹화, 우선순위 및 상태 추적 기능을 갖춘 AI 에이전트용 영구 작업 관리자 MCP 도구입니다. 읽기 작업은 항상 무료입니다. 쓰기 작업에는 Veyra 커밋 모드 인증이 필요합니다.

개요

veyra-tasks는 SQLite 기반의 안정적인 작업 관리 계층을 AI 에이전트에 제공합니다. 에이전트는 자유롭게 작업을 나열하고 확인할 수 있습니다. 작업 생성, 업데이트, 완료 및 삭제는 Veyra 커밋 모드에 의해 보호되므로 의도적이고 책임 있는 쓰기 작업이 보장됩니다.

설치

npm install
npm run build

작업은 ~/.veyra-tasks/data.db에 저장되며, 처음 실행 시 자동으로 생성됩니다.

MCP 구성 (Claude Desktop)

claude_desktop_config.json에 다음을 추가하세요:

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

도구

도구	입력	클래스	가격
`list_tasks`	`{ status?, project?, priority? }`	—	무료
`get_task`	`{ id }`	—	무료
`create_task`	`{ title, description?, priority?, project?, due?, veyra_token? }`	A	€0.005
`update_task`	`{ id, status?, title?, priority?, veyra_token? }`	A	€0.005
`complete_task`	`{ id, veyra_token? }`	A	€0.005
`delete_task`	`{ id, veyra_token? }`	B	€0.02

상태 값

todo · in_progress · done

우선순위 값

low · medium · high · urgent

예시

읽기 (토큰 불필요)

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

쓰기 (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_..."
  }
}

토큰 누락 시 오류 응답

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

Veyra 작동 방식

Veyra는 AI 에이전트를 위한 커밋 모드 인증 계층입니다. 에이전트가 쓰기 작업을 시도할 때:

에이전트가 veyra_token 없이 도구를 호출하면 authorize_endpoint가 포함된 VeyraCommitRequired 오류를 받습니다.
에이전트(또는 사용자가 대신)가 인증 엔드포인트를 호출하여 토큰을 획득합니다.
에이전트가 veyra_token을 설정하여 도구 호출을 재시도합니다.
veyra-tasks는 쓰기 작업을 실행하기 전에 @veyrahq/sdk-node를 통해 토큰을 검증합니다.

전체 문서는 veyra.to를 참조하세요.

라이선스

MIT

veyra-tasks

veyra-tasks

개요

설치

MCP 구성 (Claude Desktop)

도구

상태 값

우선순위 값

예시

읽기 (토큰 불필요)

쓰기 (Veyra 토큰 필요)

토큰 누락 시 오류 응답

Veyra 작동 방식

라이선스

Resources

Latest Blog Posts

MCP directory API