/ Annuaire / Playground / Wax
● Communauté christopherkarani ⚡ Instantané

Wax

par christopherkarani · christopherkarani/Wax

Mémoire vectorielle native Apple Silicon — accélération Metal, récupération sous la milliseconde, packagé comme binaire Swift en local.

Wax est une couche de mémoire spécifiquement optimisée pour Apple Silicon : kernels Metal pour HNSW, API Swift in-process, front-end MCP. Utile pour les agents locaux sur Mac souhaitant un RAG rapide sans base vectorielle séparée.

Pourquoi l'utiliser

Fonctionnalités clés

Démo en direct

Aperçu en pratique

prêt

Installer

Choisissez votre client

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

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add wax-mcp -- wax mcp

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Wax

RAG local sur vos notes

👤 Développeurs ⏱ ~15 min intermediate

Quand l'utiliser : Vous souhaitez une récupération rapide et privée sur des notes Markdown.

Déroulement
  1. Indexer
    wax index ~/notes✓ Copié
    → Vecteurs construits
  2. Connecter MCP
    Ajoutez wax comme serveur MCP.✓ Copié
    → Outil visible
  3. Interroger
    Interrogez Claude — la récupération est sous la milliseconde.✓ Copié
    → Citations

Résultat : RAG privé et rapide sans base vectorielle cloud.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

wax-mcp + filesystem

Indexer l'arborescence de votre projet

Combiner wax-mcp avec filesystem : indexer l'arborescence de votre projet✓ Copié

Outils

Ce que ce MCP expose

OutilEntréesQuand appelerCoût
index (voir la documentation) Indexer un répertoire 1 appel
query (voir la documentation) k-NN sur l'index 1 appel

Coût et limites

Coût d'exécution

Quota d'API
Local
Tokens par appel
Petits chunks
Monétaire
OSS gratuit
Astuce
Ré-indexez après de gros changements ; incrémental supporté

Sécurité

Permissions, secrets, portée

Stockage des identifiants : Index sur disque
Sortie de données : Aucune

Dépannage

Erreurs courantes et correctifs

Pas de périphérique Metal

Wax requiert Apple Silicon ; repasse sur CPU sur Intel mais plus lent

Alternatives

Wax vs autres

AlternativeQuand l'utiliserCompromis
memsearchMulti-plateformePas d'accélération Metal

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills