contextatlas

ContextAtlas es un servidor MCP que le da a Claude Code un "atlas" precomputado de un código base, de modo que las preguntas arquitectónicas puedan responderse desde un paquete de contexto fusionado en lugar de muchas llamadas de grep y lectura de archivos. Qué hace - En el momento de indexación, extrae afirmaciones estructuradas de ADRs, READMEs y documentos de diseño, cadenas de documentación de símbolos exportados y mensajes de commit filtrados, vinculados a símbolos de código específicos. - En el momento de consulta, fusiona cuatro señales por símbolo: datos estructurales LSP (definición, referencias, tipos, diagnósticos), afirmaciones de intención arquitectónica, historial git (commits recientes, caliente/frío, co-cambio) y asociaciones de prueba. - Se exponen tres herramientas MCP: get_symbol_context (paquete completo para un símbolo conocido, modo multi-símbolo hasta 10), find_by_intent (búsqueda BM25 sobre texto de afirmaciones indexadas en SQLite FTS5 local) e impact_of_change (radio de explosión usando co-cambio e impacto de prueba). - La resolución de consultas es local: búsqueda en SQLite más llamadas a servidores de lenguaje locales, sin tráfico de red ni llamadas de modelo durante el uso normal. Soporte de lenguajes Se admiten TypeScript, Python, Go, Ruby y C# a través de servidores de lenguaje (typescript-language-server, Pyright, gopls, ruby-lsp, csharp-ls), que son dependencias pares que el usuario instala. Se requiere Node.js 20+. Dos rutas de configuración - Ruta de habilidades: instalar el paquete, ejecutar init, luego usar /generate-adrs, /index-atlas y /prime-atlas dentro de Claude Code; no se necesita clave API. - Ruta CLI: instalar, configurar ANTHROPIC_API_KEY, ejecutar init, generate-adrs, index y doctor. Los repos que ya tengan ADRs en docs/adr/ pueden omitir generate-adrs, ya que los ADRs existentes se extraen automáticamente. Patrón de atlas commiteado El atlas.json generado está destinado a ser commiteado en el repositorio junto con el código y los ADRs. Los compañeros que clonen el repo lo importan directamente a una caché local sin volver a ejecutar la extracción, y los contribuyentes pueden regenerarlo cuando los cambios afecten afirmaciones arquitectónicas. Los equipos que no puedan commitearlo pueden establecer atlas.committed: false y cada desarrollador ejecuta su propia extracción. Notas de privacidad En el momento de indexación, los archivos ADR/doc coincidentes por configuración, el texto de cadenas de documentación de símbolos exportados y los mensajes de commit filtrados se envían a la API de Anthropic; el código fuente, el historial git más allá de esos mensajes, los datos LSP y los contenidos de consulta en tiempo de ejecución no. Un glob docs.include que coincida con archivos fuente enviaría esos archivos completos. Los flujos de extracción pueden limitarse (por ejemplo, solo a ADRs). Todas las afirmaciones extraídas y la resolución de consultas permanecen en un archivo SQLite local. Puntos de referencia reportados El README reporta un conjunto de pruebas comparativas sobre honojs/hono, encode/httpx y spf13/cobra con prompts pre-registrados y calificación ciega, citando una reducción de tokens del 45-72% en prompts de intención arquitectónica y una ejecución de referencia de hono con un 39% menos de llamadas a herramientas en agregado. También reporta deltas de calidad emparejados (corrección factual, alucinación, capacidad de acción, completitud) con intervalos de confianza, y afirma que los grupos de prompts de empate y truco mostraron a ContextAtlas como netamente negativo, lo cual los autores presentan como esperado. Estas cifras provienen del propio repositorio de benchmarks del proyecto y deben tratarse como reportadas por el autor, no verificadas de forma independiente. Estado y licencia El README indica que v0.9.0 se lanzó el 2026-05-16 y que el paquete aún no está publicado en npm, por lo que las instrucciones de instalación describen la forma prevista. Licencia MIT.