veyra-snippets

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

Обзор

veyra-snippets предоставляет ИИ-агентам надежную библиотеку кода на базе SQLite. Агенты могут свободно просматривать и искать фрагменты кода. Сохранение, обновление и удаление фрагментов защищено режимом фиксации Veyra, что обеспечивает осознанные и подотчетные действия по записи.

Related MCP server: Snippets MCP

Установка

npm install
npm run build

Фрагменты кода хранятся в ~/.veyra-snippets/data.db, файл создается автоматически при первом запуске.

Конфигурация MCP (Claude Desktop)

Добавьте следующее в ваш claude_desktop_config.json:

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

Инструменты

Примеры

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

// List all snippets
{ "tool": "list_snippets", "arguments": {} }

// List TypeScript snippets
{ "tool": "list_snippets", "arguments": { "language": "typescript" } }

// List snippets by tag
{ "tool": "list_snippets", "arguments": { "tag": "auth" } }

// Get a specific snippet
{ "tool": "get_snippet", "arguments": { "id": "1712345678-abc1234" } }

// Search across title, code, language, and tags
{ "tool": "search_snippets", "arguments": { "query": "debounce" } }

Запись (требуется токен Veyra)

// Save a new snippet
{
  "tool": "save_snippet",
  "arguments": {
    "title": "Debounce utility",
    "code": "function debounce(fn, ms) {\n  let timer;\n  return (...args) => {\n    clearTimeout(timer);\n    timer = setTimeout(() => fn(...args), ms);\n  };\n}",
    "language": "javascript",
    "tags": "utility,performance",
    "veyra_token": "vt_..."
  }
}

// Update snippet code
{
  "tool": "update_snippet",
  "arguments": {
    "id": "1712345678-abc1234",
    "code": "// updated code here",
    "veyra_token": "vt_..."
  }
}

// Delete a snippet
{
  "tool": "delete_snippet",
  "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-snippets проверяет токен через @veyrahq/sdk-node перед выполнением записи.

Полную документацию см. на veyra.to.

Лицензия

MIT

Хостинг-пакет (рекомендуется)

Рекомендуем использовать хостинг-пакет для интеграции по одной ссылке:

{
  "mcpServers": {
    "veyra": {
      "url": "https://mcp.veyra.to/sse"
    }
  }
}

Одна ссылка. 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