代码Graph MCP 服务器
AI特工的跨语言代码情报——42个工具,38个语言,持续内存,文档情报,一次性公关审查.
安装
npm install -g @astudioplus/codegraph-mcp
分析引擎没有被捆绑在包里.
安装从 GitHub 发布时为您的平台所建的引擎 -
标记为 发动机 版本, npm 唯一的补丁发布不会
移动 - 并验证它与出版 .sha256 在安装前
(在Windows上,ONNX运行时的副车也随之而来).
下载失败不会失败安装, 因为 CLI、 钩和 文件都还在工作 - 它会打印一个警告。 重试用 :
npx codegraph-mcp-fetch-engine # --force re-downloads an engine that is already present
装有空气的机器 或者你自己卖二进制
CODEGRAPH_SKIP_BINARY_FETCH=1 以跳过下载和提供引擎之一
采用两种方式:
- 放在这
<package>/bin/codegraph-server-<platform>-<arch>(单位:千美元).exe打开 Windows) - 路径codegraph-mcpa. 默认发射;或 - 点
CODEGRAPH_SERVER_PATH在引擎 它已经住的地方。 这个 胜过被捆绑的道路codegraph-mcp缺少清晰的消息失败 而不是倒下 如果什么都没有.
使用量
克劳德代码
添加为 ~/.claude.json数字 :
{
"mcpServers": {
"codegraph": {
"command": "codegraph-mcp",
"args": []
}
}
}
Cursor / Windsurf / Cline / 其他 MCP 客户端
同样的配置—— codegraph-mcp 命令以 MCP (stdio) 模式启动服务器.
选项
后传出旗帜 --数字 :
{
"mcpServers": {
"codegraph": {
"command": "codegraph-mcp",
"args": ["--workspace", "/path/to/project", "--exclude", "vendor"]
}
}
}
离开运输 args数字 : codegraph-mcp 已经将引擎放入
MCP( stdio) 模式, 所以 --mcp, (中文(简体) ), --stdio 财务报告和审定财务报表 --connect 从
无论客户通过什么 而不是两次转发.
| 旗帜 | 默认 | 说明 |
|---|---|---|
--workspace <path> | 当前目录 | 索引目录( 可重复) |
--exclude <dir> | —— 说 | 跳过目录( 可重复) |
--embedding-model <model> | bge-small | bge-small, (中文(简体) ), jina-code-v2, (中文(简体) ), granite-97m (32K,多语种),或 static (模型2vec,~100×更快地索引,~BGE质量的90%;需要一个本地模型目录 - 此安装下载到 ~/.codegraph/static_models/jina-code-static-256点 CODEGRAPH_STATIC_MODEL 其他地方) |
--max-files <n> | 5000块 | 要索引的最大文件 |
--profile <name> | all | 范围工具表面 : core (8), (中文), graph (17个), memory (14个), security (赞成), all (42个) |
--graph-only | 关 | 跳过嵌入式——仅图+结构工具. 没有ONNX型号载荷,10-50×更快地索引. CI / 一发图查询 . |
--run-tool <name> | —— 说 | 一拍:索引,运行一个单一工具,打印结果,退出. 没有MCP握手。 与 --tool-args '<json>'。 。 。 . |
解决问题: 嵌入已禁用 / “ 未初始化的记忆管理器 ”
在装入 ONNX 嵌入模型之前, 服务器检查可用的内存和
如果在 ~1.5 GB 下, 只运行图, 所以一个 OOM 杀法无法将进程取下 .
如果那能阻止火灾, index_markdown, (中文(简体) ), search_docs, (中文(简体) ), memory_*,以及
语义搜索不可用, 而只使用图表的工具则继续工作 .
- 读取
0 MB available检测失败和模型 无论如何,负载. 在macOS上,可回收的内存被停放在不活动/投机/可清除的页面中 有些记忆读取者不认为是免费的,所以健康的Mac可以报告0. - 如果嵌入器被禁用 即使机器有足够的免费RAM,
设定
CODEGRAPH_SKIP_MEMORY_CHECK=1(还接受)true编号 :yes绕过 完全检查.
两者都应用 MCP 模式和一发 --run-tool 模式.
代理规则(建议)
预配置规则文件在返回到grep/多文件之前,教你的AI代理使用CodeGraph工具,其内容如下:
GitHub 动作——自动公关审查
获取一个代码分析评论 每一个PR——爆炸半径,测试漏洞,
过时的文件,推荐的审查者。 运行 只有图表 (没有嵌入,没有)
API 密钥, 只是 GITHUB_TOKEN) (中文(简体) ). 核心援引:
codegraph-server --graph-only \
--run-tool codegraph_pr_context \
--tool-args '{"baseBranch":"main","format":"markdown"}'
这个打印出一个即时的标记下 PR 注释 。 复制复制工作流程
模板存在于 .github/workflows/codegraph-pr.yml 在主重播时.
可选: Claude 代码中的自动上下文注射
安装一个 PreTooLUS 钩子, 使 Claude 能够获取图表上下文(get_edit_context, (中文(简体) ), analyze_impact在索引工作空间中编辑源文件之前。 跳过非源文件并静默地编辑 。 从不阻断工具呼叫.
npx codegraph-mcp-install-hooks # interactive prompt
npx codegraph-mcp-install-hooks --dry # preview the change
npx codegraph-mcp-install-hooks --force # skip prompt
npx codegraph-mcp-install-hooks --uninstall
工具(42个)
分析 (11个): get_ai_context, (中文(简体) ), get_edit_context, (中文(简体) ), get_curated_context, (中文(简体) ), analyze_impact, (中文(简体) ), analyze_complexity, (中文(简体) ), find_circular_deps, (中文(简体) ), find_hot_paths, (中文(简体) ), find_dead_imports, (中文(简体) ), get_module_summary, (中文(简体) ), search_by_pattern, (中文(简体) ), search_by_error
公关审查 (1): pr_context ——一通电话PR分析:爆炸半径,测试漏洞,呆滞的docs,承诺提示,推荐的审查者. 支助 format:"markdown" 以备随时张贴.
导航 (13个): symbol_search, (中文(简体) ), get_callers, (中文(简体) ), get_callees, (中文(简体) ), get_detailed_symbol, (中文(简体) ), get_symbol_info, (中文(简体) ), get_dependency_graph, (中文(简体) ), get_call_graph, (中文(简体) ), find_by_imports, (中文(简体) ), find_by_signature, (中文(简体) ), find_entry_points, (中文(简体) ), find_implementors, (中文(简体) ), find_related_tests, (中文(简体) ), traverse_graph
内存 (7): memory_store, (中文(简体) ), memory_get, (中文(简体) ), memory_search, (中文(简体) ), memory_context, (中文(简体) ), memory_list, (中文(简体) ), memory_stats, (中文(简体) ), memory_invalidate
文档 (7): index_markdown, (中文(简体) ), search_docs, (中文(简体) ), list_doc_sources, (中文(简体) ), remove_doc_source, (中文(简体) ), verify_design, (中文(简体) ), design_gaps, (中文(简体) ), generate_architecture_doc
索引编制 (3): reindex_workspace, (中文(简体) ), index_files, (中文(简体) ), index_directory
所有工具名称前缀为 codegraph_ (例如:. codegraph_symbol_search) (中文(简体) ).
语文(38)
系统: C, C++, Rust, Zig,目标-C
联合核查团:爪哇,克特林,斯卡拉,格鲁维,克洛朱尔
网页/脚本: TypeScript/JS, Python, Ruby, PHP, Perl, Lua, Elixir, 榆树
网络/系统: 中央支助
移动:斯威夫特,达特
职能:哈斯凯尔、OCAML、朱莉娅、埃尔朗
企业: C#,COBOL,福特兰,去
区链: 团结
壳/图: Bash, HCL/Terraform, TOML, YAML, 多克文件
硬件: Verilog/系统Verilog, TCl
数据科学页:1
遥测
匿名使用遥测帮助改进了CodeGraph. 被跟踪的事件:工具引用(名称+持续时间),启动,出错. 没有文件路径,代码内容,也没有发送过PII.
选择出: 已设定 CODEGRAPH_TELEMETRY=off 在你的环境.
许可证
阿帕奇 -2.0 - (英语) GitHub 图像