freemcplab / Diretório / Playground / Semble

● Comunidade MinishLab ⚡ Instantâneo

Semble

Name: Semble MCP Server
Author: MinishLab

Busca de código que custa ~2% de grep+read em tokens — semântica + lexical, totalmente local, sub-segundo em repositórios com milhões de linhas.

Semble é um MCP de busca de código da Minish Lab. Ele indexa um repositório com embeddings híbridos esparsos+densos e serve ao Claude resultados de busca semântica mais precisos que grep — sem precisar despejar arquivos inteiros. O uso de tokens é dramaticamente menor que o padrão 'grep depois ler', especialmente em grandes monorepos.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por que usar

Principais recursos

Recuperação híbrida esparsa + densa — encontra tanto símbolos exatos quanto correspondências conceituais
~98% de redução de tokens vs linha de base de grep+read
Queries sub-segundo mesmo em repositórios com mais de 1M de linhas
Embeddings totalmente locais — sem chamadas de API
Indexação incremental conforme os arquivos mudam

Demo ao vivo

Como fica na prática

semble-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "semble-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "semble-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "semble-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "semble-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  }
}

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

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "semble-mcp",
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "semble-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "--from",
          "semble[mcp]",
          "semble"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add semble-mcp -- uvx --from semble[mcp] semble

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

Casos de uso

Usos do mundo real: Semble

Encontrar onde um conceito é implementado em um repositório grande

👤 Engenheiros explorando bases de código grandes ⏱ ~5 min beginner

Quando usar: Você precisa responder 'onde a validação de token de sessão acontece?' de uma vez.

Pré-requisitos

Repositório indexado — semble index . — a primeira execução leva alguns minutos para repositórios grandes

Fluxo

Buscar

Use semble. Encontre onde vive a lógica de validação de token de sessão. Retorne intervalos file:line.✓ Copiado

→ 3-5 resultados com intervalos concretos de file:line
Leitura precisa

Leia apenas esses intervalos de linhas (não os arquivos inteiros). Resuma o fluxo de validação.✓ Copiado

→ Resumo conciso do fluxo; pequena pegada de tokens

Resultado: Pergunta respondida com uma fração dos tokens que grep+read consumiria.

Armadilhas

Índice desatualizado após grandes rebases — semble reindex ou configure um hook de file-watcher

Combine com: filesystem

Auditar como um padrão de código é usado em um repositório

👤 Equipes de refatoração ⏱ ~15 min intermediate

Quando usar: Você vai descontinuar um helper e quer todos os seus usos e variantes.

Fluxo

Passagem lexical

Encontre todas as chamadas para legacy_token_check.✓ Copiado

→ Lista de correspondências exatas
Passagem semântica

Encontre funções que fazem o mesmo trabalho com um nome diferente.✓ Copiado

→ Implementações similares sinalizadas

Resultado: O escopo da refatoração é totalmente conhecido antes de começar.

Armadilhas

Falsos positivos na passagem semântica — Verifique cada candidato; o semble fornece uma pontuação de similaridade para triagem

Combinações

Combine com outros MCPs para 10× de alavancagem

semble-mcp + filesystem

Padrão de busca → leitura precisa (apenas os intervalos que o semble retorna)

Use semble para encontrar candidatos, depois filesystem para ler apenas os intervalos correspondentes.✓ Copiado

semble-mcp + github

Construir um PR de refatoração com todos os call sites atualizados

Encontre todos os call sites com semble, gere um PR que atualiza cada um.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search	query, k?, mode?	Padrão — busca por conceito	free
lexical_search	pattern, k?	Tokens exatos / regex	free
index	path	Primeira execução / após grande reestruturação	free
reindex	path	Atualizar após edições	free

Custo e limites

O que custa rodar

Cota de API: Nenhuma — local
Tokens por chamada: Mínimo — geralmente 100–500
Monetário: Gratuito
Dica: Indexe o repositório uma vez; as queries são baratas. A economia de tokens se acumula.

Segurança

Permissões, segredos, alcance

Escopos mínimos: Leitura local de arquivos para indexação

Armazenamento de credenciais: Nenhum

Saída de dados: Nenhuma — embeddings ficam locais

Solução de problemas

Erros comuns e correções

Indexação com OOM em repositórios gigantes

Reduza o tamanho do batch na configuração ou indexe por pacote

A busca não retorna nada relevante

Re-indexe — sua cópia local pode ter divergido; ou refine a query

Instalação via uvx trava

Pré-aquecça com uv pip install semble[mcp]

Alternativas

Semble vs. outros

Alternativa	Quando usar	Troca
ripgrep + grep MCP	Você só precisa de busca por correspondência exata	Sem recall semântico; maior custo de tokens nos resultados
ast-grep / serena	Você quer busca estrutural com consciência de sintaxe	Modelo diferente; não baseado em embeddings

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills