veyra-notes

Инструмент MCP для постоянного хранения заметок для ИИ-агентов с фильтрацией по тегам и полнотекстовым поиском. Чтение всегда бесплатно. Операции записи требуют авторизации в режиме фиксации Veyra.

Обзор

veyra-notes предоставляет ИИ-агентам надежный уровень для ведения заметок на базе 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"]
    }
  }
}

Инструменты

Примеры

Чтение (токен не требуется)

// 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 — это уровень авторизации в режиме фиксации для ИИ-агентов. Когда агент пытается выполнить операцию записи:

1. Агент вызывает инструмент без veyra_token и получает ошибку VeyraCommitRequired с authorize_endpoint.

2. Агент (или пользователь от его имени) вызывает конечную точку авторизации для получения токена.

3. Агент повторяет вызов инструмента с установленным veyra_token.

4. 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/sse

Манифест пакета: https://mcp.veyra.to/.well-known/veyra-pack.json

Используйте размещенный пакет, если вам нужен самый быстрый путь интеграции MCP для всех семейств инструментов Veyra. Используйте этот автономный пакет, если вам нужен конкретно этот инструмент отдельно.

Часть экосистемы Veyra

Veyra — это режим фиксации для производственных действий ИИ-агентов. Все инструменты: чтение бесплатно, запись требует режима фиксации Veyra.

SDK: npm install @veyrahq/sdk-node Веб-сайт: veyra.to