jcodemunch-mcp

jCodeMunch MCP 是一个 Model Context Protocol (MCP) 服务器，旨在减少代码探索过程中的 AI token 消耗。它使用 tree-sitter 将源代码解析为本地符号索引（函数、类、方法、常量），并带有字节级偏移量，使代理能够只检索所需的精确代码，而不是读取整个文件。 主要能力包括： - 符号级检索：`get_symbol_source` 返回精确的函数体，`search_symbols` 按名称查找符号，`get_file_outline` 提供结构化摘要。 - 结构化查询：`find_importers`、`get_blast_radius`、`get_call_hierarchy`、`find_dead_code`、`get_changed_symbols`、`get_hotspots`，以及基于 AST 的反模式搜索。 - 任务上下文组装：`assemble_task_context` 对任务意图进行分类，并在 token 预算内运行相应的工具序列。 - 安全检查：`check_edit_safe`、`check_delete_safe`、`get_pr_risk_profile` 和 `plan_refactoring`，提供可编辑块，并与类型检查器诊断（mypy、pyright、tsc、ruff）集成。 - 置信度分数、新鲜度标记、覆盖率契约、密钥脱敏，以及基于 SCIP 的编译器验证引用。 - 通过 watch 模式、代理钩子和 VS Code 扩展实现索引自动保持最新。 基准测试声称，在三个公共代码库上，相比 grep-and-read 基线，token 减少 28.3 倍（节省 96.5%），各代码库的节省范围为 15.6 倍至 39.7 倍。一项针对生产环境 Vue 3 代码库的独立 A/B 测试报告称，工具层节省 15-25%，并提高了成功率。 安装方式为 `uv tool install jcodemunch-mcp` 或 `uvx jcodemunch-mcp`，并带有 `init` 命令，可自动配置 MCP 客户端并安装 CLAUDE.md 提示策略。通过 tree-sitter 支持 70 多种语言、monorepo 和增量索引。采用本地优先设计，索引存储在 `~/.code-index/` 中；可选的匿名节省计数器（可退出）。 许可为双用途：个人使用免费，产生收入的用途需要商业许可证。