Sobre o projeto

O jCodeMunch MCP é um servidor Model Context Protocol (MCP) projetado para reduzir o consumo de tokens de IA durante a exploração de código. Ele usa tree-sitter para analisar o código-fonte em um índice local de símbolos (funções, classes, métodos, constantes) com deslocamentos em nível de byte, permitindo que agentes recuperem apenas o código exato de que precisam em vez de ler arquivos inteiros. As principais capacidades incluem: - Recuperação em nível de símbolo: `get_symbol_source` retorna corpos exatos de funções, `search_symbols` encontra símbolos por nome, `get_file_outline` fornece resumos estruturais. - Consultas estruturais: `find_importers`, `get_blast_radius`, `get_call_hierarchy`, `find_dead_code`, `get_changed_symbols`, `get_hotspots` e buscas de anti-padrões baseadas em AST. - Montagem de contexto de tarefa: `assemble_task_context` classifica a intenção da tarefa e executa a sequência apropriada de ferramentas dentro de um orçamento de tokens. - Verificações de segurança: `check_edit_safe`, `check_delete_safe`, `get_pr_risk_profile` e `plan_refactoring` com blocos prontos para edição, além de integração com diagnósticos de verificadores de tipos (mypy, pyright, tsc, ruff). - Pontuações de confiança, sinalizadores de atualidade, contratos de cobertura, redação de segredos e referências verificadas por compilador baseadas em SCIP. - Atualidade automática do índice via modos watch, hooks de agente e uma extensão do VS Code. Os benchmarks alegam uma redução de 28,3x em tokens em comparação com uma linha de base de grep-and-read (96,5% de economia) em três repositórios públicos, com economias por repositório variando de 15,6x a 39,7x. Um teste A/B independente em uma base de código Vue 3 de produção relatou 15-25% de economia na camada de ferramentas e taxas de sucesso melhoradas. A instalação é via `uv tool install jcodemunch-mcp` ou `uvx jcodemunch-mcp`, com um comando `init` que configura automaticamente clientes MCP e instala uma política de prompt CLAUDE.md. Suporta mais de 70 linguagens via tree-sitter, monorepos e indexação incremental. Design local-first com índices armazenados em `~/.code-index/`; contador anônimo opcional de economia (opt-out). O licenciamento é de uso duplo: gratuito para uso pessoal, licenças comerciais exigidas para uso que gere receita.