/ Verzeichnis / Playground / Wax
● Community christopherkarani ⚡ Sofort

Wax

von christopherkarani · christopherkarani/Wax

Apple-Silicon-native Vektorspeicher — Metal-beschleunigt, Sub-ms-Retrieval, als Swift-Binary lokal ausführbar.

Wax ist eine Speicherschicht, die speziell für Apple Silicon optimiert ist: Metal-Kernel für HNSW, In-Process-Swift-API, MCP-Frontend. Nützlich für lokale Agents auf dem Mac, die schnelles RAG ohne separaten Vektor-DB-Dienst wollen.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

bereit

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "wax-mcp": {
      "command": "wax",
      "args": [
        "mcp"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "wax-mcp": {
      "command": "wax",
      "args": [
        "mcp"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "wax-mcp": {
      "command": "wax",
      "args": [
        "mcp"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "wax-mcp": {
      "command": "wax",
      "args": [
        "mcp"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "wax-mcp",
      "command": "wax",
      "args": [
        "mcp"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "wax-mcp": {
      "command": {
        "path": "wax",
        "args": [
          "mcp"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add wax-mcp -- wax mcp

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Wax

Lokales RAG über deine Notizen

👤 Entwickler ⏱ ~15 min intermediate

Wann einsetzen: Du möchtest schnelles, privates Retrieval über Markdown-Notizen.

Ablauf
  1. Indizieren
    wax index ~/notes✓ Kopiert
    → Vektoren erstellt
  2. MCP verdrahten
    wax als MCP-Server hinzufügen.✓ Kopiert
    → Tool sichtbar
  3. Abfragen
    Claude fragen — Retrieval ist Sub-ms.✓ Kopiert
    → Zitate

Ergebnis: Privates, schnelles RAG ohne Cloud-Vektor-DB.

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

wax-mcp + filesystem

Den Projektbaum indizieren

Combine wax-mcp with filesystem: Index your project tree✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
index (see docs) Ein Verzeichnis indizieren 1 call
query (see docs) k-NN über den Index 1 call

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
Lokal
Tokens pro Aufruf
Winzige Chunks
Kosten in €
Kostenlos (OSS)
Tipp
Bei großen Änderungen neu indizieren; inkrementell wird unterstützt

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: On-Disk-Index
Datenabfluss: Keine

Fehlerbehebung

Häufige Fehler und Lösungen

Kein Metal-Gerät

Wax erfordert Apple Silicon; fällt auf Intel auf CPU zurück, aber langsamer

Alternativen

Wax vs. andere

AlternativeWann stattdessenKompromiss
memsearchCross-PlatformKeine Metal-Beschleunigung

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen