
让Cursor更懂你的代码库CodeGraph完整接入教程【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraphCodeGraph 是一款 100% 本地运行的代码知识图谱工具通过 MCP 协议为 Cursor、Claude Code、Codex 等 AI 编程助手提供语义级代码智能。本文将带你完成 CodeGraph 完整接入流程3 步安装配置让 Cursor 更少地盲搜文件直接回答结构问题实现更少的 token 消耗与工具调用。为什么需要 CodeGraph 代码知识图谱AI 编程助手如 Cursor在回答这个功能是怎么实现的这类问题时默认做法是用grepRead逐个文件盲扫。文件多、调用链长时token 消耗爆炸答案还常常漏掉关键路径。CodeGraph 的思路是预建索引用 tree-sitter 解析代码把每个函数、类、路由、组件存入本地 SQLite 数据库把调用、导入、继承等关系建成知识图谱通过 MCP 协议暴露给 Cursor 等 Agent一次调用即可拿到带行号的源码 调用路径 影响面官方在 7 个真实开源仓库上的实测数据指标提升工具调用次数减少 58%回答速度快 22%文件读取接近零 原理详解可参考 knowledge-graph.md 与 how-it-works.md一键安装 CodeGraph三种方式任选方式一npx 一条命令推荐新手npx colbymchenry/codegraph方式二npm 全局安装已有 Node.js 的用户npm i -g colbymchenry/codegraph codegraph install方式三shell 脚本macOS / Linux无需 Node安装脚本源码install.sh、install.ps1CodeGraph 自带运行时无需编译、无原生依赖Windows、macOS、Linux 全平台支持x64 与 arm64。随时可用codegraph upgrade升级。接入 Cursor 的完整配置步骤安装完成后执行交互安装器codegraph install它会自动完成以下工作无需手动改配置自动检测已安装的 Agent——Cursor、Claude Code、Codex CLI、Gemini 等勾选你要接入的写入 MCP 服务器配置——将 CodeGraph 接入 Cursor 的 MCP 配置处理 Cursor 的特殊问题——Cursor 启动 MCP 子进程时工作目录不正确安装器会自动注入--path参数修复手动配置时需注意这一点⚠️codegraph install只负责连接 Agent不会索引任何代码。索引代码是下一步的事。也可以用非交互方式显式指定目标codegraph install --targetcursor,claude --yesCursor 对应的安装器目标实现位于 src/installer/targets/cursor.ts支持的 Agent 清单见 targets/registry.ts。初始化项目构建你的代码图谱进入你的项目目录执行初始化cd your-project codegraph init一条命令即完成创建本地.codegraph/目录并构建完整的代码知识图谱。之后Agent 会检测到.codegraph/目录并自动启用 CodeGraph 工具——你什么都不用改。全局安装一次codegraph install后每个项目只需单独执行一次codegraph init。零同步代码改动自动更新图谱这是最省心的一点自动同步默认开启。CodeGraph 会监视项目文件变化——无论你是用 Cursor 改代码还是自己新增、修改、删除文件图谱都会实时增量更新。索引永远不会过期不需要手动重跑任何命令同步机制实现见 src/sync/watcher.ts 与 watch-policy.ts接入后 Cursor 如何提问才最有效CodeGraph 默认只暴露一个 MCP 工具codegraph_explore。用法很简单——直接给自然语言问题或符号名登录接口是怎么鉴权的 checkout 流程经过哪些组件它会返回相关符号的逐行号源码按文件分组与 Read 工具同构符号间的调用路径——包括 grep 跟不上的动态分发回调、React 重渲染、JSX 子组件影响面摘要哪些代码依赖这些符号也就是说问X 是怎么工作的这类问题1 次调用通常就够了。MCP 服务器实现位于 src/mcp/tools.ts工具协议说明见 mcp-server.md。除 MCP 外每个工具都有 CLI 等价命令codegraph explore/node/callers/impact等方便脚本调用。CLI 完整参考cli.md。常见问题速查接入后 Cursor 没反应重启 Cursor 让 MCP 服务器加载确认项目根目录存在.codegraph/即已执行codegraph init。支持哪些语言TypeScript、JavaScript、Python、Go、Rust、Java、Kotlin、Swift、C/C 等 30 语言完整清单见 languages.md。数据安全吗100% 本地——没有 API key、没有外部服务数据只存在本地 SQLite 文件中。想卸载codegraph uninstall一条命令从所有 Agent 中移除配置项目索引可用codegraph uninit单独清理。总结3 步让 Cursor 升级装npm i -g colbymchenry/codegraph接codegraph install自动接入 Cursor建项目内codegraph init之后无需任何维护——改动自动同步Agent 自动使用。更多集成细节可查阅 integrations.md 与 troubleshooting.md。【免费下载链接】codegraphPre-indexed code knowledge graph, auto syncs on code changes, for Claude Code, Codex, Gemini, Cursor, OpenCode, AntiGravity, Kiro, CoPilot, and Hermes Agent — fewer tokens, fewer tool calls, 100% local项目地址: https://gitcode.com/GitHub_Trending/co0degr/codegraph创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考