convez.ai
MCP ServerBusca & PesquisaIntermediário
jaymeklein

EmbedBase

jaymeklein/embedbase

Embedding e busca semântica de documentos local-first com MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Plataforma local-first de embedding e retrieval de documentos com REST API e servidor MCP para agentes de IA. Combina busca semântica com BM25 híbrido, suportando múltiplos backends de vetores (Chroma, pgvector, Qdrant) e parsers plugáveis sem exfiltração de dados.

Instalação

$npx convez-ai jaymeklein/embedbase

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • RAG privado para agentes Claude via MCP
  • Indexação e retrieval de documentos em ambientes isolados
  • Busca híbrida BM25 + semântica em coleções de workspace

Veredito

Solução sólida para quem precisa de RAG privado com flexibilidade de backend. Integração MCP nativa com Claude Desktop/Cursor é prático, mas setup Docker com configuração manual de chaves de API requer atenção à segurança em redes compartilhadas.

README

A tradução para o português deste README ainda está na fila.

EmbedBase

A local-first, open-source document embedding system. Ingest documents, search them semantically, and expose results via REST API and MCP server — all without data leaving your machine.

Quickstart

# Clone inside WSL2 (not /mnt/c — see WSL2 notes below)
git clone https://github.com/your-org/embedbase
cd embedbase

# Configure
cp .env.example .env
# Edit .env: set MASTER_API_KEY to a random 32+ char string
# e.g. python -c "import secrets; print(secrets.token_urlsafe(32))"

cp config.example.yaml config.yaml  # already done if this file exists

# Start the stack (downloads ~90MB model on first run)
docker compose up --build

# UI:  http://localhost:3000
# API: http://localhost:8000
# Docs: http://localhost:8000/docs

Vector store backends

# Default — Chroma
docker compose up

# pgvector (Postgres 16)
docker compose -f docker-compose.yml -f docker-compose.postgres.yml up

# Qdrant
docker compose -f docker-compose.yml -f docker-compose.qdrant.yml up

MCP (Claude Desktop / Cursor / Zed)

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "embedbase": {
      "command": "curl",
      "args": ["-N", "http://localhost:8000/mcp/sse"],
      "env": {
        "AUTHORIZATION": "Bearer <your-collection-api-key>"
      }
    }
  }
}

WSL2 notes

  • Clone inside the WSL2 filesystem (~/) — not /mnt/c/
  • Allocate at least 8 GB RAM in %UserProfile%\.wslconfig
  • Use host.docker.internal to reach services on the Windows host (e.g. Ollama)

Security checklist (shared networks)

  • Put Nginx behind a TLS reverse proxy (Caddy recommended)
  • Set a strong, random MASTER_API_KEY (min 32 chars)
  • Remove the ports mapping for api — Nginx is the only ingress
  • Set CHROMA_AUTH_TOKEN to a non-default value
  • Set EMBEDBASE_SECURE_HEADERS=true

License

Apache 2.0

Ver o original no GitHub

Bom para

Relacionados