veyra-notes

태그 필터링 및 전문 검색 기능을 갖춘 AI 에이전트용 영구 메모 시스템 MCP 도구입니다. 읽기 작업은 항상 무료입니다. 쓰기 작업에는 Veyra 커밋 모드 인증이 필요합니다.

개요

veyra-notes는 SQLite 기반의 안정적인 메모 작성 계층을 AI 에이전트에 제공합니다. 에이전트는 자유롭게 메모를 읽고, 나열하고, 검색할 수 있습니다. 메모 생성, 수정, 삭제는 Veyra 커밋 모드로 보호되어 의도적이고 책임 있는 쓰기 작업을 보장합니다.

설치

npm install
npm run build

메모는 ~/.veyra-notes/data.db에 저장되며, 처음 실행 시 자동으로 생성됩니다.

MCP 구성 (Claude Desktop)

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

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

도구

도구	입력	클래스	가격
`list_notes`	`{ tag?, limit? }`	—	무료
`get_note`	`{ id }`	—	무료
`search_notes`	`{ query }`	—	무료
`create_note`	`{ title, content, tags?, veyra_token? }`	A	€0.005
`update_note`	`{ id, content?, title?, veyra_token? }`	A	€0.005
`delete_note`	`{ id, veyra_token? }`	B	€0.02

예시

읽기 (토큰 불필요)

// List all notes
{ "tool": "list_notes", "arguments": {} }

// List notes by tag
{ "tool": "list_notes", "arguments": { "tag": "project-x" } }

// Get a specific note
{ "tool": "get_note", "arguments": { "id": "1712345678-abc1234" } }

// Search across title, content, and tags
{ "tool": "search_notes", "arguments": { "query": "meeting notes" } }

쓰기 (Veyra 토큰 필요)

// Create a note
{
  "tool": "create_note",
  "arguments": {
    "title": "Sprint Planning",
    "content": "Goals for this sprint: ...",
    "tags": "work,planning",
    "veyra_token": "vt_..."
  }
}

// Update a note
{
  "tool": "update_note",
  "arguments": {
    "id": "1712345678-abc1234",
    "content": "Updated content...",
    "veyra_token": "vt_..."
  }
}

// Delete a note
{
  "tool": "delete_note",
  "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-notes는 쓰기 작업을 실행하기 전에 @veyrahq/sdk-node를 통해 토큰을 검증합니다.

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

라이선스

MIT

veyra-notes

veyra-notes

개요

설치

MCP 구성 (Claude Desktop)

도구

예시

읽기 (토큰 불필요)

쓰기 (Veyra 토큰 필요)

토큰 누락 시 오류 응답

Veyra 작동 방식

라이선스

Resources

Latest Blog Posts

MCP directory API