veyra-notes
veyra-notes
Инструмент MCP для постоянного хранения заметок для ИИ-агентов с фильтрацией по тегам и полнотекстовым поиском. Чтение всегда бесплатно. Операции записи требуют авторизации в режиме фиксации Veyra.
Обзор
veyra-notes предоставляет ИИ-агентам надежный уровень для ведения заметок на базе 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"]
}
}
}Инструменты
Инструмент | Входные данные | Класс | Цена |
|
| — | БЕСПЛАТНО |
|
| — | БЕСПЛАТНО |
|
| — | БЕСПЛАТНО |
|
| 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 — это уровень авторизации в режиме фиксации для ИИ-агентов. Когда агент пытается выполнить операцию записи:
Агент вызывает инструмент без
veyra_tokenи получает ошибкуVeyraCommitRequiredсauthorize_endpoint.Агент (или пользователь от его имени) вызывает конечную точку авторизации для получения токена.
Агент повторяет вызов инструмента с установленным
veyra_token.veyra-notesпроверяет токен через@veyrahq/sdk-nodeперед выполнением записи.
Полную документацию см. на veyra.to.
Лицензия
MIT
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