veyra-snippets

Ein persistentes Code-Snippet-Manager-MCP-Tool für KI-Agenten mit Sprachfilterung, Tag-Suche und Volltext-Code-Suche. Lesezugriffe sind immer kostenlos. Schreibvorgänge erfordern eine Autorisierung über den Veyra Commit-Modus.

Übersicht

veyra-snippets bietet KI-Agenten eine zuverlässige Code-Bibliothek auf Basis von SQLite. Agenten können Snippets frei durchsuchen und finden. Das Speichern, Aktualisieren und Löschen von Snippets ist durch den Veyra-Commit-Modus geschützt – dies stellt bewusste und nachvollziehbare Schreibvorgänge sicher.

Related MCP server: Snippets MCP

Installation

npm install
npm run build

Snippets werden unter ~/.veyra-snippets/data.db gespeichert und beim ersten Start automatisch erstellt.

MCP-Konfiguration (Claude Desktop)

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

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

Tools

Beispiele

Lesen (kein Token erforderlich)

// 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" } }

Schreiben (Veyra-Token erforderlich)

// 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_..."
  }
}

Fehlerantwort bei fehlendem Token

{
  "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"
}

Funktionsweise von Veyra

Veyra ist eine Autorisierungsschicht für den Commit-Modus bei KI-Agenten. Wenn ein Agent einen Schreibvorgang versucht:

1. Der Agent ruft das Tool ohne veyra_token auf und erhält einen VeyraCommitRequired-Fehler mit einem authorize_endpoint.

2. Der Agent (oder der Benutzer in seinem Namen) ruft den Autorisierungs-Endpunkt auf, um ein Token zu erhalten.

3. Der Agent wiederholt den Tool-Aufruf mit gesetztem veyra_token.

4. veyra-snippets verifiziert das Token über @veyrahq/sdk-node, bevor der Schreibvorgang ausgeführt wird.

Weitere Informationen finden Sie unter veyra.to in der vollständigen Dokumentation.

Lizenz

MIT

Hosted Pack (empfohlen)

Bevorzugen Sie das Hosted Pack für eine Integration über eine einzige URL:

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

Eine URL. 48 Tools. 24 kostenlose Lesezugriffe. 24 geschützte Schreibzugriffe.

Hosted Pack: https://mcp.veyra.to/sse

Pack-Manifest: https://mcp.veyra.to/.well-known/veyra-pack.json

Verwenden Sie das Hosted Pack, wenn Sie den schnellsten MCP-Integrationspfad für alle Veyra-Tool-Familien wünschen. Verwenden Sie dieses eigenständige Paket, wenn Sie dieses Tool gezielt einzeln nutzen möchten.

Teil des Veyra-Ökosystems

Veyra ist der Commit-Modus für produktive KI-Agenten-Aktionen. Alle Tools: Lesezugriffe kostenlos, Schreibzugriffe erfordern den Veyra-Commit-Modus.