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