veyra-notes

Ein persistentes Notizsystem als MCP-Tool für KI-Agenten, mit Tag-Filterung und Volltextsuche. Lesezugriffe sind immer kostenlos. Schreibvorgänge erfordern eine Autorisierung über den Veyra Commit-Modus.

Übersicht

veyra-notes bietet KI-Agenten eine zuverlässige Notiz-Ebene auf Basis von SQLite. Agenten können Notizen frei lesen, auflisten und durchsuchen. Das Erstellen, Aktualisieren und Löschen von Notizen ist durch den Veyra-Commit-Modus geschützt – dies stellt bewusste und nachvollziehbare Schreibvorgänge sicher.

Related MCP server: Bruin

Installation

npm install
npm run build

Notizen werden unter ~/.veyra-notes/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-notes": {
      "command": "node",
      "args": ["/absolute/path/to/veyra-notes/dist/index.js"]
    }
  }
}

Tools

Beispiele

Lesen (kein Token erforderlich)

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

Schreiben (Veyra-Token erforderlich)

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

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 Autorisierungsebene 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-notes verifiziert das Token über @veyrahq/sdk-node, bevor der Schreibvorgang ausgeführt wird.

Siehe veyra.to für die vollständige 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 speziell für sich allein benötigen.

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.

SDK: npm install @veyrahq/sdk-node Website: veyra.to