veyra-notes
veyra-notes
一个为 AI 智能体提供的持久化笔记系统 MCP 工具,支持标签过滤和全文搜索。读取始终免费。写入操作需要 Veyra 提交模式授权。
概述
veyra-notes 为 AI 智能体提供了一个基于 SQLite 的可靠笔记层。智能体可以自由读取、列出和搜索笔记。创建、更新和删除笔记受到 Veyra 提交模式的保护,确保写入操作是有意且可追溯的。
Related MCP server: Bruin
安装
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"]
}
}
}工具
工具 | 输入 | 类别 | 价格 |
|
| — | 免费 |
|
| — | 免费 |
|
| — | 免费 |
|
| A | €0.005 |
|
| A | €0.005 |
|
| 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
托管包(推荐)
建议使用托管包以实现单 URL 集成:
{
"mcpServers": {
"veyra": {
"url": "https://mcp.veyra.to/sse"
}
}
}一个 URL。48 个工具。24 个免费读取。24 个受保护的写入。
包清单: https://mcp.veyra.to/.well-known/veyra-pack.json
当你希望在所有 Veyra 工具系列中实现最快的 MCP 集成路径时,请使用托管包。 当你专门需要此工具独立运行时,请使用此独立包。
Veyra 生态系统的一部分
Veyra 是生产级 AI 智能体操作的提交模式。 所有工具:读取免费,写入需要 Veyra 提交模式。
工具 | 描述 | 安装 |
键值内存存储 |
| |
任务管理 |
| |
代码片段存储 |
| |
书签管理器 |
| |
联系人管理 |
| |
表单构建器 |
| |
Webhook 发送器 |
|
SDK: npm install @veyrahq/sdk-node 网站: veyra.to
This server cannot be deployed
Maintenance
Related MCP Connectors
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
- TaprootOAuthcom.taproothq
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Save notes in seconds. Your AI can then search, read, write and tag them over MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceA simple note-taking MCP server for recording and managing notes with AI models.45 npm36GPL 2.0
- AlicenseNot gradedqualityCmaintenanceMCP server for AI agents to read, write, and organize notes in a local-first, human-in-the-loop note-taking app.4 npm2MIT
- FlicenseNot gradedqualityCmaintenanceMCP server for a full-stack note-taking application, exposing CRUD tools for notes with SSE transport for AI agent integration.1-
- AlicenseAqualityAmaintenanceMCP server for managing a local, domain-agnostic knowledge base using Markdown notes with frontmatter. Enables AI agents to capture, read, search, link, and maintain notes with atomic writes and privacy controls.13MIT