← 返回目录

CodeMunch MCP

社区

基于 AST 的高效代码检索，减少 95% 以上代码探索 Token。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 199 / 438
Stars: ★ 2.8k 非常热门
传输方式: stdio（本地进程）
运行环境: Python
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 8 天前
工具数: 13

54FMRS · D

一个面向 AI 辅助开发的本地优先代码检索服务器，核心价值是 tree-sitter 符号级检索、结构分析和 Token 控制。它适合代码探索密集型工作流，但用户应评估本地索引、可选遥测、网络扩展和商业许可条件。

最强项 · 文档质量 13/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

9/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 清单声明了 PyPI stdio 包，启动路径在形式上可信；但清单版本为 1.44.0，而 README 同时引用 1.56.0、1.108.154 和 1.108.163，工具数量及功能描述也不一致。未提供可核查的 CI、提交记录或服务器关键路径测试，因此无法证明初始化、工具列表握手和边界错误处理，按静态校准扣分。
安全与权限 12/20: README 披露了默认匿名节省遥测、后台发送线程、会话日志中的路径与查询字符串，以及可选的许可证、下载和 AI 提供商网络调用，并提供退出配置；也说明了若干写配置、安装钩子和登录服务的行为。没有证据显示凭据窃取或隐蔽外泄，但默认遥测、敏感路径/查询记录、索引本地代码及声明的权限控制均缺少源代码验证，且危险操作的确认边界不完整，因此扣分。
维护活跃度 9/20: README 显示项目有持续发布、版本升级和公开仓库，但这些只是未验证的文档声明。清单为 NOASSERTION，README 的个人免费/商业付费双重使用条款缺少可核查许可证文件证据；未提供依赖更新策略、安全响应渠道、提交活动或治理细节，因此不能按持续成熟维护给高分。
文档质量 13/20: 文档覆盖安装、客户端配置、网络行为、可选依赖、遥测、故障排查、工具概览和成本定位，证据范围较广。扣分来自明显的版本与基准数字矛盾、README 内容极度宣传化、声明的大量功能和测试/遥测结果缺少可核查源文件证据，以及所给材料在配置说明处不完整。
安装易用性 12/20: 提供 pip、uvx、Claude Code、VS Code、Cursor 等多种安装示例，并说明 Windows PATH、Python/uv 前置条件和调试方式，主路径可理解。扣分来自运行时与版本未固定、不同客户端依赖额外手工配置、init 可能写配置/钩子、可选网络和提供商依赖较多，以及没有真实 CI 或测试证明跨平台连接流程。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络

适合谁

需要分析大型或陌生代码库的开发者
使用 Claude Code、Cursor 或其他 MCP 客户端的工程团队
重视本地索引、精确检索和 Token 成本控制的用户

不适合谁

只需要通用聊天或网页浏览的用户
不希望在本地建立代码索引的环境
需要官方产品维护者支持或明确开源许可证的企业采购场景

所需权限

需要读取待索引的本地代码目录或 GitHub 仓库内容。
需要在本地写入索引和会话数据，默认位置为 ~/.code-index/，可通过 CODE_INDEX_PATH 覆盖。
若启用文件监视、Agent hooks 或登录服务，需要相应的本地文件和服务配置权限。
匿名 Token 节省统计默认可能发送到项目公共计量服务；可通过 share_savings 或 JCODEMUNCH_SHARE_SAVINGS=0 关闭。

风险与副作用

源代码索引和会话日志会在本地保存；会话日志包含访问过的路径和查询字符串。
启用分享统计会产生出站网络请求；AI 摘要、嵌入模型、许可证验证和 Starter Pack 也可能产生用户发起的网络请求。
部分可选扩展可能访问麦克风或处理图像；这些功能不属于核心 MCP 服务器。
README 声明个人非商业用途免费，商业用途需要付费许可证；仓库元数据中的许可证为 NOASSERTION。
Token 节省和检索准确率取决于索引完整性、语言支持和查询方式，不应视为无条件保证。

安装接入

准备工作

运行环境：Python

安装 Python 包：pip install jcodemunch-mcp，或直接使用 uvx jcodemunch-mcp。然后将提供的 stdio 配置添加到 MCP 客户端，并重启客户端。也可以运行 jcodemunch-mcp init 自动检测并配置部分客户端。首次使用时索引本地目录或 GitHub 仓库。

.mcp.json

{"mcpServers":{"jcodemunch":{"command":"uvx","args":["jcodemunch-mcp"]}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "jcodemunch": {
      "command": "uvx",
      "args": [
        "jcodemunch-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add jcodemunch -- uvx jcodemunch-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后用 `jcodemunch-mcp --version` 确认版本；在客户端中让 agent 调用 search_symbols 和 get_symbol_source，若返回的是几十行精确代码而非整份文件，再用 get_session_stats 查看本次会话的 token 节省量，即证明连接成功。

常见排障

确认 jcodemunch-mcp 或 uvx 已安装并位于 MCP 客户端可访问的 PATH 中。
运行 jcodemunch-mcp --version 和 jcodemunch-mcp config --check 检查安装、配置和前置条件。
检查 MCP 客户端的服务器日志；Claude Code 可使用 claude --mcp-debug。
确认目标目录已建立索引，并在文件变更后重新索引或启用 watch。
若客户端只显示少量工具，检查 tool_profile、tool_surface 和 disabled_tools 配置；counter 模式下可使用 menu() 浏览工具目录。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 jcodemunch 索引这个仓库。
用 jcodemunch 找到处理认证的函数并显示其源码。
如果我修改这个函数，会影响哪些地方？用 get_blast_radius 分析一下。
用 find_dead_code 检查仓库里有没有没人调用的死代码。

工具能力 13

search_symbols 只读

按名称、类型或语言搜索代码符号。

get_symbol_source 只读

获取指定符号的精确源代码实现。

get_context_bundle 只读

在 Token 预算内获取多个相关符号及其上下文。

assemble_task_context 只读

根据自然语言任务自动分类意图、提取符号并组装带来源的上下文。

plan_turn 只读

在读取代码前规划工具调用、目标符号和 Token 预算。

get_ranked_context 只读

按查询相关性和 PageRank 返回预算内的符号上下文。

find_importers 只读

查找导入指定文件或模块的代码。

get_blast_radius 只读

分析修改符号可能影响的调用者和依赖项。

展开其余 5 个工具

get_call_hierarchy 只读

遍历符号的调用者和被调用者。

find_dead_code 只读

查找不可达的符号和文件。

get_changed_symbols 只读

将 Git 差异映射到新增、修改或删除的符号。

search_ast 只读

跨语言搜索结构化 AST 模式和预设反模式。

winnow_symbols 只读

按类型、复杂度、调用、文件、Git 变更和重要性等条件组合筛选符号。

使用场景

按符号精确检索大型代码库

代码库入门、调试和重构

变更影响、调用层级和死代码分析

减少 AI 代码探索的上下文和 Token 消耗

跨 70 多种语言执行 AST 结构查询

支持客户端

Claude Code

Cursor

VS Code

Codex部分支持

Continue部分支持

Windsurf部分支持

Autohand Code部分支持

Claude Desktop部分支持

依据项目文档列出，未经本站实测。

详细介绍

jcodemunch-mcp 是一个通过 tree-sitter AST 解析代码库、提供符号级 GitHub 和本地代码检索的 MCP 服务器。它可索引 70 多种语言，按函数、类、方法、常量、调用关系和代码结构返回精确上下文，减少读取完整文件带来的 Token 消耗。索引默认保存在本地。