lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio mcpclaude-codecodexrust

Pluck: busca y lee símbolos de código mediante MCP

Localiza funciones y dependencias sin cargar archivos completos y entrega al agente fragmentos de código centrados en su tarea.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.


Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: instala las herramientas

Comprueba que Rust y Cargo están disponibles, junto con compiladores C/C++ para las dependencias nativas. Los manifiestos de Pluck no fijan un mínimo numérico de Rust; usa un entorno estable actual que resuelva sus dependencias. En Linux revisa también OpenSSL y pkg-config para la dependencia native-tls declarada en el Cargo.toml. Si prefieres binarios, sigue la alternativa Homebrew del README antes de registrar MCP.

cargo install pluck-mcp pluck-cli

Paso 2: registra el proyecto

El README da esta sintaxis para Claude Code; sustituye el parámetro por la ruta real:

claude mcp add --transport stdio --scope project pluck -- pluckd --repo <repo-root>

Recarga el cliente si lo requiere. Pide una búsqueda de código y verifica qué herramienta utiliza antes de añadir reglas permanentes.

Comprobación

El servidor pluck debe conectarse y exponer herramientas de lectura y búsqueda. Compara una función recuperada con el archivo original y comprueba una referencia conocida.

Si algo falla

Si no encuentra símbolos, revisa la raíz indexada y los formatos soportados. Si el agente sigue leyendo archivos completos, revisa su política de recuperación; no confundas eso con un fallo del servicio en segundo plano.

ver en .md ¿Prefieres el recurso entero?

Qué es

Pluck es un servicio local de recuperación de código para agentes. Expone búsquedas y lecturas de símbolos mediante MCP y acompaña al servicio con una CLI independiente.

Para qué te sirve

  • Cuando el agente lee varios archivos enteros para encontrar una función.
  • Cuando necesitas revisar quién llama a un símbolo antes de cambiarlo.
  • Cuando los registros de compilación ocupan demasiado contexto y quieres conservar los errores útiles.

Cómo funciona

El índice combina búsqueda léxica y semántica con fragmentos delimitados por la estructura del código. Sus herramientas permiten ver esquemas, firmas, cuerpos de símbolos y relaciones de dependencia. La deduplicación de sesión busca evitar lecturas repetidas.

El repositorio publica benchmarks (pruebas comparativas), pero su ahorro de tokens depende del código y de que el agente use realmente esas herramientas. Instalar un servidor MCP no cambia automáticamente todas las decisiones de lectura del cliente.

Antes de empezar

Necesitas un cliente MCP y el servicio en segundo plano (pluckd) junto con la CLI. La ruta descrita compila ambos con Rust y Cargo; Homebrew es otra alternativa documentada. El índice trabaja sobre la ruta del repositorio que configures; revisa esa ruta antes de activar reglas persistentes de recuperación.

Límites y alternativas

La indexación puede omitir contexto necesario y no reemplaza la lectura exacta cuando importa el contenido completo. Mantén una vía de búsqueda y lectura convencional para formatos no soportados. Evalúa la calidad de los fragmentos antes de imponer que todas las búsquedas pasen por Pluck.

Recursos

  • Repositorio y README - 42 estrellas; licencia detectada por GitHub: MIT.
  • Licencia - Consulta sus condiciones antes de reutilizar el proyecto.