Sobre el proyecto

jCodeMunch MCP es un servidor de Model Context Protocol (MCP) diseñado para reducir el consumo de tokens de IA durante la exploración de código. Utiliza tree-sitter para analizar el código fuente en un índice local de símbolos (funciones, clases, métodos, constantes) con desplazamientos a nivel de byte, lo que permite a los agentes recuperar solo el código exacto que necesitan en lugar de leer archivos completos. Las capacidades clave incluyen: - Recuperación a nivel de símbolo: `get_symbol_source` devuelve cuerpos de funciones exactos, `search_symbols` encuentra símbolos por nombre, `get_file_outline` proporciona resúmenes estructurales. - Consultas estructurales: `find_importers`, `get_blast_radius`, `get_call_hierarchy`, `find_dead_code`, `get_changed_symbols`, `get_hotspots` y búsquedas de anti-patrones basadas en AST. - Ensamblaje de contexto de tareas: `assemble_task_context` clasifica la intención de la tarea y ejecuta la secuencia de herramientas adecuada bajo un presupuesto de tokens. - Comprobaciones de seguridad: `check_edit_safe`, `check_delete_safe`, `get_pr_risk_profile` y `plan_refactoring` con bloques listos para editar, además de integración con diagnósticos de verificadores de tipos (mypy, pyright, tsc, ruff). - Puntuaciones de confianza, indicadores de frescura, contratos de cobertura, redacción de secretos y referencias verificadas por compilador basadas en SCIP. - Frescura automática del índice mediante modos de vigilancia, hooks de agentes y una extensión de VS Code. Los benchmarks afirman una reducción de 28,3x en tokens frente a una línea base de grep-and-read (96,5 % de ahorro) en tres repositorios públicos, con ahorros por repositorio que van de 15,6x a 39,7x. Una prueba A/B independiente en una base de código de producción en Vue 3 reportó ahorros del 15-25 % en la capa de herramientas y mejores tasas de éxito. La instalación se realiza mediante `uv tool install jcodemunch-mcp` o `uvx jcodemunch-mcp`, con un comando `init` que configura automáticamente los clientes MCP e instala una política de prompts CLAUDE.md. Admite más de 70 lenguajes mediante tree-sitter, monorepos e indexación incremental. Diseño local-first con índices almacenados en `~/.code-index/`; contador anónimo de ahorros opcional (con opción de exclusión). La licencia es de doble uso: gratuita para uso personal, con licencias comerciales requeridas para uso que genere ingresos.