Skip to main content
Glama

veyra-notes

一个为 AI 智能体提供的持久化笔记系统 MCP 工具,支持标签过滤和全文搜索。读取操作始终免费。写入操作需要 Veyra 提交模式授权。

概述

veyra-notes 为 AI 智能体提供了一个由 SQLite 支持的可靠笔记层。智能体可以自由读取、列出和搜索笔记。创建、更新和删除笔记受到 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 智能体提供的提交模式授权层。当智能体尝试执行写入操作时:

  1. 智能体在调用工具时未提供 veyra_token,并收到带有 authorize_endpointVeyraCommitRequired 错误。

  2. 智能体(或代表它的用户)调用授权端点以获取令牌。

  3. 智能体使用设置好的 veyra_token 重试工具调用。

  4. veyra-notes 在执行写入前通过 @veyrahq/sdk-node 验证令牌。

请参阅 veyra.to 获取完整文档。

许可证

MIT

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Aquariosan/veyra-notes'

If you have feedback or need assistance with the MCP directory API, please join our Discord server