/ Diretório / Playground / Wax
● Comunidade christopherkarani ⚡ Instantâneo

Wax

por christopherkarani · christopherkarani/Wax

Memória vetorial nativa para Apple Silicon — acelerado por Metal, recuperação sub-ms, empacotado como binário Swift executado localmente.

Wax é uma camada de memória especificamente otimizada para Apple Silicon: kernels Metal para HNSW, API Swift in-process, frontend MCP. Útil para agentes locais no Mac que querem RAG rápido sem um banco de dados vetorial separado.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

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

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

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

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

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

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

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

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

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

O Continue usa um array de objetos de servidor em vez de um map.

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add wax-mcp -- wax mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Wax

RAG local sobre suas notas

👤 Desenvolvedores ⏱ ~15 min intermediate

Quando usar: Você quer recuperação rápida e privada sobre notas em Markdown.

Fluxo
  1. Indexar
    wax index ~/notes✓ Copiado
    → Vetores construídos
  2. Conectar MCP
    Adicione wax como servidor MCP.✓ Copiado
    → Ferramenta visível
  3. Consultar
    Pergunte ao Claude — recuperação é sub-ms.✓ Copiado
    → Citações

Resultado: RAG privado e rápido sem banco de dados vetorial na nuvem.

Combinações

Combine com outros MCPs para 10× de alavancagem

wax-mcp + filesystem

Indexe sua árvore de projeto

Combine wax-mcp com filesystem: Indexe sua árvore de projeto✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
index (ver docs) Indexa um diretório 1 chamada
query (ver docs) k-NN sobre o índice 1 chamada

Custo e limites

O que custa rodar

Cota de API
Local
Tokens por chamada
Chunks pequenos
Monetário
OSS gratuito
Dica
Reindexe em grandes mudanças; incremental suportado

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Índice em disco
Saída de dados: Nenhum

Solução de problemas

Erros comuns e correções

Sem dispositivo Metal

Wax requer Apple Silicon; faz fallback para CPU em Intel mas é mais lento

Alternativas

Wax vs. outros

AlternativaQuando usarTroca
memsearchMultiplataformaSem aceleração Metal

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills