Optimizando la búsqueda de código en Claude Code con Semble MCP — Cómo reducir tokens un 98% y guía práctica

Optimizando la búsqueda de código en Claude Code con Semble MCP — Cómo reducir tokens un 98% y guía práctica

¿Qué es Semble MCP?

Semble MCP es un servidor de búsqueda de código local de alta velocidad diseñado específicamente para agentes de IA de programación. Está concebido para proporcionar a agentes como Claude Code, Cursor y OpenAI Codex una "exploración de código más inteligente que grep y más ligera que RAG".

Normalmente, un agente de IA combina grep, ripgrep, lectura completa de archivos y búsqueda por embeddings para encontrar código; Semble optimiza ese proceso de forma especializada.

"¿Dónde está el proceso de autenticación?"
"Implementación de save model"
"Inicialización de Firebase"

Con búsqueda en lenguaje natural, devuelve rápidamente solo los fragmentos de código necesarios.

Características principales

Procesamiento local ultrarrápido

Semble funciona únicamente con CPU. No requiere GPU.

• Generación de índice del repositorio: aprox. 250ms
• Búsqueda: aprox. 1.5ms

Reducción significativa del uso de tokens

Comparado con "grep + lectura de archivos", permite acceder al código necesario con un 98% menos de tokens. Al operar Claude Code durante mucho tiempo en proyectos grandes, el efecto en la reducción de costes es muy considerable.

Seguridad: diseño completamente local

La descripción oficial destaca:

• No requiere clave API
• Sin comunicación con servicios externos
• Operación completa mediante rutas locales

La generación de índices, búsqueda, generación de embeddings y búsqueda BM25 se procesan todas dentro del PC local.

Cómo añadirlo a Claude Code

Se requiere uv. Puede añadirse con el siguiente comando:

claude mcp add semble -s user -- uvx --from "semble[mcp]" semble

Durante la instalación obtiene el paquete de PyPI, pero las operaciones posteriores funcionan completamente de forma local.

Combinación con Sub-agent

Además de la versión MCP, Semble también existe en versión CLI. Dado que el Sub-agent de Claude Code puede no poder usar MCP en algunos casos, se recomienda especificar el uso de la versión CLI en CLAUDE.md o AGENTS.md.

Use `semble search` instead of grep for codebase exploration.

Escribiendo esto, múltiples agentes usarán Semble de forma consistente.

Uso práctico

# Búsqueda en lenguaje natural
semble search "authentication flow" ./my-project
semble search "Firebase initialization" ./my-project
semble search "query submission process" ./my-project --top-k 10

# Exploración de código relacionado (especificando ruta de archivo y número de línea)
semble find-related src/auth.py 42 ./my-project

Distribución de roles con otras herramientas

Semble es exclusivamente una herramienta especializada en búsqueda de código. Es importante entender la distribución de roles con otros MCP.

Concretamente:

• context7 → "Quiero conocer las especificaciones oficiales de Jetpack Compose"
• Semble → "Quiero buscar código de Compose en mi proyecto"

La compilación, lint, ejecución de tests y operaciones de base de datos están fuera del alcance de Semble.

¿Para qué proyectos es adecuado?

Casos donde es más efectivo

• Repositorios enormes
• Proyectos Android (Jetpack Compose, Firebase mixto, estructura multi-module)
• Uso intensivo de Sub-agent con operación de AGENTS.md
• Uso prolongado y continuo de Claude Code

Casos donde no es muy necesario

• Repositorios pequeños (pocos archivos)
• Trabajos puntuales

Consideraciones de seguridad

Aunque Semble en sí tiene un diseño completamente local, hay algunos puntos a tener en cuenta al usarlo.

Los resultados de búsqueda se pasan al LLM

Semble no envía código al exterior, pero los resultados de búsqueda que devuelve se pasan al LLM a través de Claude Code.

Código local
  ↓ Búsqueda Semble (completamente local)
  ↓ Pasar resultados de búsqueda a Claude
  ↓ LLM los procesa

Es decir, hay que considerar el envío al LLM, no Semble en sí.

Ejemplo de configuración segura

Si la seguridad es prioritaria, se recomienda una configuración que minimice los MCP con comunicación externa.

Claude Code
├ Semble (local)
├ filesystem MCP (local)
├ git MCP (local)
└ terminal (local)

Al manejar código confidencial o datos empresariales, es más importante verificar las políticas de telemetry y retención de conversaciones del lado del LLM que el propio Semble.

Conclusión

Semble MCP es una herramienta de alto valor para los ingenieros que utilizan Claude Code profesionalmente.

• Reducción significativa de costes de tokens (hasta un 98%)
• Búsqueda de código en lenguaje natural
• Seguro con diseño completamente local
• Efecto multiplicado al combinarlo con Sub-agent

Simplemente reemplazando las partes donde se escaneaban muchos archivos con grep por Semble, la eficiencia de operación del agente cambia notablemente. Especialmente en proyectos grandes y configuraciones multi-agente, vale la pena considerar una implementación temprana.