documentation-lookup

Búsqueda de Documentación (Context7)

Cuando el usuario pregunte sobre bibliotecas, frameworks o APIs, obtén la documentación actualizada a través del servidor MCP Context7 (herramientas resolve-library-id y query-docs) en lugar de depender de los datos de entrenamiento.

Conceptos Clave

• Context7: Servidor MCP que expone documentación en vivo; úsalo en lugar de los datos de entrenamiento para bibliotecas y APIs.
• resolve-library-id: Devuelve IDs de biblioteca compatibles con Context7 (ej. /vercel/next.js) a partir de un nombre de biblioteca y una consulta.
• query-docs: Obtiene documentación y fragmentos de código para un ID de biblioteca y una pregunta determinados. Siempre llama a resolve-library-id primero para obtener un ID de biblioteca válido.

Cuándo Usarlo

Actívalo cuando el usuario:

• Haga preguntas de configuración o instalación (ej. "¿Cómo configuro el middleware de Next.js?")
• Solicite código que dependa de una biblioteca ("Escribe una consulta de Prisma para...")
• Necesite información de API o referencia ("¿Cuáles son los métodos de autenticación de Supabase?")
• Mencione frameworks o bibliotecas específicas (React, Vue, Svelte, Express, Tailwind, Prisma, Supabase, etc.)

Usa esta habilidad siempre que la solicitud dependa del comportamiento preciso y actualizado de una biblioteca, framework o API. Aplica en todos los entornos que tengan configurado el servidor MCP Context7 (ej. Claude Code, Cursor, Codex).

Cómo Funciona

Paso 1: Resolver el ID de la Biblioteca

Llama a la herramienta MCP resolve-library-id con:

• libraryName: El nombre de la biblioteca o producto extraído de la pregunta del usuario (ej. Next.js, Prisma, Supabase).
• query: La pregunta completa del usuario. Esto mejora la relevancia de los resultados.

Debes obtener un ID de biblioteca compatible con Context7 (formato /org/proyecto o /org/proyecto/versión) antes de consultar la documentación. No llames a query-docs sin un ID de biblioteca válido de este paso.

Paso 2: Seleccionar la Mejor Coincidencia

De los resultados de resolución, elige un resultado usando:

• Coincidencia de nombre: Prefiere la coincidencia exacta o más cercana a lo que preguntó el usuario.
• Puntuación de referencia: Puntuaciones más altas indican mejor calidad de documentación (100 es la máxima).
• Reputación de la fuente: Prefiere fuentes con reputación Alta o Media cuando estén disponibles.
• Versión: Si el usuario especificó una versión (ej. "React 19", "Next.js 15"), prefiere un ID de biblioteca con versión específica si aparece (ej. /org/proyecto/v1.2.0).

Paso 3: Obtener la Documentación

Llama a la herramienta MCP query-docs con:

• libraryId: El ID de biblioteca de Context7 seleccionado en el Paso 2 (ej. /vercel/next.js).
• query: La pregunta o tarea específica del usuario. Sé específico para obtener fragmentos relevantes.

Límite: no llames a query-docs (ni a resolve-library-id) más de 3 veces por pregunta. Si la respuesta no está clara después de 3 llamadas, indica la incertidumbre y usa la mejor información que tengas en lugar de adivinar.

Paso 4: Usar la Documentación

• Responde a la pregunta del usuario usando la información actualizada obtenida.
• Incluye ejemplos de código relevantes de la documentación cuando sea útil.
• Cita la biblioteca o versión cuando sea importante (ej. "En Next.js 15...").

Ejemplos

Ejemplo: Middleware de Next.js

1. Llama a resolve-library-id con libraryName: "Next.js", query: "¿Cómo configuro el middleware de Next.js?".
2. De los resultados, elige la mejor coincidencia (ej. /vercel/next.js) por nombre y puntuación de referencia.
3. Llama a query-docs con libraryId: "/vercel/next.js", query: "¿Cómo configuro el middleware de Next.js?".
4. Usa los fragmentos y texto devueltos para responder; incluye un ejemplo mínimo de middleware.ts de la documentación si es relevante.

Ejemplo: Consulta de Prisma

1. Llama a resolve-library-id con libraryName: "Prisma", query: "¿Cómo hago consultas con relaciones?".
2. Selecciona el ID de biblioteca oficial de Prisma (ej. /prisma/prisma).
3. Llama a query-docs con ese libraryId y la consulta.
4. Devuelve el patrón de Prisma Client (ej. include o select) con un fragmento de código corto de la documentación.

Ejemplo: Métodos de autenticación de Supabase

1. Llama a resolve-library-id con libraryName: "Supabase", query: "¿Cuáles son los métodos de autenticación?".
2. Elige el ID de biblioteca de la documentación de Supabase.
3. Llama a query-docs; resume los métodos de autenticación y muestra ejemplos mínimos de la documentación obtenida.

Mejores Prácticas

• Sé específico: Usa la pregunta completa del usuario como consulta cuando sea posible para obtener mejor relevancia.
• Conciencia de versión: Cuando los usuarios mencionen versiones, usa IDs de biblioteca con versión específica del paso de resolución cuando estén disponibles.
• Prefiere fuentes oficiales: Cuando existan múltiples coincidencias, prefiere los paquetes oficiales o principales sobre forks de la comunidad.
• Sin datos sensibles: Elimina claves de API, contraseñas, tokens y otros secretos de cualquier consulta enviada a Context7. Trata la pregunta del usuario como posiblemente conteniendo secretos antes de pasarla a resolve-library-id o query-docs.