Sobre el proyecto

Scantool es un servidor MCP (Protocolo de contexto de modelo) diseñado para mejorar las interacciones de los agentes de IA con las bases de código proporcionando un análisis estructurado en lugar de volcados de archivos sin procesar. Impulsado por Tree-sitter, admite más de 20 lenguajes de programación, incluyendo Python, JavaScript, TypeScript, Rust, Go, C/C++, Java, PHP, C#, Ruby, Zig, Swift, SQL, HTML, CSS y Markdown. La herramienta extrae clases, métodos, funciones, importaciones, gráficos de llamadas y funciones calientes con números de línea exactos, lo que permite a los agentes comprender la arquitectura del código de manera eficiente. Características clave incluyen: - **Infraestructura cero**: No se necesita indexación, claves de API, bases de datos de vectores o descargas de modelos. Escanea directorios bajo demanda. - **Soporte multilingüe**: Analiza tanto el código como los documentos (Markdown, HTML, CSS, SQL, configuración) a través de una lente unificada. - **Integración CLI**: Instala automáticamente un comando de shell `sct` junto con el servidor MCP, lo que permite a los agentes utilizar las mismas herramientas de análisis directamente en la terminal. Esto incluye comandos para escanear, enfocarse en nodos específicos, buscar, diferenciar y resolver referencias entre ramas de git. - **Herramientas de análisis avanzadas**: - `preview_directory`: Proporciona descripciones generales de alto nivel con puntos de entrada, gráficos de importación y funciones calientes. - `scan_file`: Ofrece análisis estructurales detallados con firmas, decoradores y docstrings. Admite un parámetro `focus` para leer nodos específicos textualmente. - `scan_directory`: Genera árboles de directorio compactos con nombres de clase/función en línea. - `search_structures`: Filtra el código por tipo, patrón de nombre, decorador o complejidad. - `find_divergence`: Audita directorios para funciones que rompen patrones de llamada esperados. - **Formatos de salida**: Admite visualizaciones en formato de árbol con caracteres de dibujo de cuadro y JSON para uso programático. La salida está optimizada para el consumo de LLM con mejoras de eficiencia de tokens medibles sobre enfoques tradicionales basados en grep. - **Compatibilidad**: Funciona sin problemas con Claude Code, Claude Desktop, Cursor, Windsurf, VS Code (modo de agente Copilot) y Cline.