code-review-graph 切换 venv 后 MCP 仍指向旧解释器修复 .mcp.json 与 hook 路径【免费下载链接】code-review-graphLocal-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.项目地址: https://gitcode.com/GitHub_Trending/co/code-review-graph如果你在跑过code-review-graph install之后又创建或切换了 Python 虚拟环境venvClaude Code 里的 MCP server 很可能还在用旧环境.mcp.json和.claude/settings.json中的解释器路径是在install时写死的切换 venv 不会自动更新。文档描述的后果是 server 会静默失败或者启动的是错误的 Python表现常是图已经 build 了但新会话里 Claude Code 看不到 graph 工具。这篇文章给出文档中提供的两种修复方式在激活的 venv 内重跑install推荐或手动改.mcp.json与 hook 命令。适用前提是你使用 Claude Code 作为 MCP 客户端其配置文件为项目内的.mcp.json.claude/settings.json并且项目中已安装过 code-review-graph。为什么切换 venv 会让配置失效code-review-graph 的组成部分有不同的作用域见 docs/TROUBLESHOOTING.mdPython 包是用户级的安装一次即可图数据库是项目级的位于每个项目内的.code-review-graph/graph.dbMCP server 配置.mcp.json也是项目级的Claude Code 为每个项目各启动一个 MCP servercwdproject从该目录读取graph.db.claude/settings.json中的 hooks 与 MCP 工具路径同样是在install时硬编码的。所以如果你在install之后才source .venv/bin/activate配置文件里记录的还是当时环境的解释器路径新环境不会回填这些路径。先确认故障现象切换 venv 后典型的判断依据来自 docs/TROUBLESHOOTING.md 第 5 节/mcp里没列出code-review-graph在 Claude Code 内运行/mcp查看 server 状态。如果status显示图存在但/mcp不列出该 server说明.mcp.json不在当前会话的cwd下——MCP server 以cwdproject启动新会话如果开在父目录或别的项目就读不到你 build 的图。server 启动即崩溃在 Claude Code 内运行/mcp看状态macOS 上还可以查~/Library/Logs/Claude/mcp*.log。忘了重跑installbuild只创建graph.db把 MCP server 注册进 Claude Code 的是install写.mcp.json两者都要有。install 后没重启Claude Code 在启动时才读取.mcp.json改完配置必须完全退出再重新打开。修复方式一在激活的 venv 内重跑 install推荐这是文档给出的最短路径。先激活你的 venv再在项目根目录重跑install它会重写.mcp.json和 hook 路径source .venv/bin/activate # activate your venv first code-review-graph install # rewrites .mcp.json and hook paths然后完全退出 Claude Code 再重新打开不是重开会话窗口文档要求 fully quit让它加载新配置。注意两点必须在目标项目根目录下执行因为.mcp.json是项目级的如果你的 CLI 装在 venv 里、不在 PATH 上导致code-review-graph: command not found可参考 docs/TROUBLESHOOTING.md 第 2 节的 pipx /python -m code_review_graph install等替代方式但执行环境要保持在同一个 venv 内否则生成的路径又会指向错误解释器。修复方式二手动修改 .mcp.json 与 hook 命令如果暂时不能重跑install可以手工把配置指到新 venv。文档给出的.mcp.json示例文档原文示例其中/path/to/your/venv需替换为你自己的 venv 绝对路径{ mcpServers: { code-review-graph: { command: /path/to/your/venv/bin/uvx, args: [code-review-graph, serve] } } }文档说明这里应point to your venvs Python or uvx inside the venv即command既可以写 venv 内的uvx也可以指向 venv 的 Python。除.mcp.json外还要把.claude/settings.json里的 hook 命令一并按新 venv 更新——hooks 负责在编辑/会话开始时增量更新图路径不对的话图会停留在旧状态。补充说明install生成的 hook 命令带有 PATH 守卫command -v code-review-graph /dev/null 21 || exit 0见 code_review_graph/skills.py当code-review-graph不在$PATH上时 hook 会静默退出而不报错所以图不更新了未必伴随报错信息。验证修复是否生效按 docs/TROUBLESHOOTING.md 的 checklist在项目根目录依次执行cd /path/to/your/project code-review-graph status # should print Files/Nodes/Edges from the built graph ls .mcp.json # should exist cat .mcp.json # should reference code-review-graph serve # then: fully quit Claude Code and reopen it inside this project判断标准code-review-graph status应打印出已 build 图的 Files/Nodes/Edges 统计见 docs/FAQ.md节点数为零通常意味着 build 没跑或没解析到内容此时先补code-review-graph buildcat .mcp.json应能看到引用code-review-graph serve且command指向新 venv完全退出并重新打开 Claude Code 后运行/mcp确认code-review-graphserver 已连接并列出其工具再向助手提一个结构性问题例如 what callsparse_file?观察它使用query_graph而不是全文检索验证方法来自 docs/FAQ.md。如果status正常但/mcp仍不列出 server说明.mcp.json不在会话cwd下——回到正确的项目根目录重跑code-review-graph install。限制与边界本问题的根因是install 时硬编码路径文档明确它针对 venv 场景需要手动处理用 pipx / uvx 全局安装不依赖项目 venv可规避路径漂移但那是安装方式选择不属于本修复路径。.mcp.json是项目级配置每个需要 graph 的项目各自有一份build与install都要在该项目内执行。若.mcp.json使用自定义配置文档建议它使用command: uvx与args: [code-review-graph, serve]无 venv 场景并可用uvx code-review-graph serve单独验证 server 能否无错启动uv缺失时先uv --version检查。更多排查项数据库锁、图过旧、watcher 状态等见 docs/TROUBLESHOOTING.md 其他章节与 venv 切换无直接关系时不必展开。【免费下载链接】code-review-graphLocal-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.项目地址: https://gitcode.com/GitHub_Trending/co/code-review-graph创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考