# @astudioplus/codegraph-mcp 中文文档

规范地址：https://npmcn.com/package/%40astudioplus/codegraph-mcp/

版本：0\.21\.0
npm 元数据更新时间：2026-10-06T03:01:06.647Z
中文译文更新时间：2026-11-07T01:21:10.899Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40astudioplus/codegraph-mcp
原文对照：https://npmcn.com/package/%40astudioplus/codegraph-mcp/?lang=original
项目主页：https://github.com/codegraph-ai/CodeGraph#readme
源码仓库：https://github.com/codegraph-ai/CodeGraph

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：69.6 kB，11 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：1 个
- 首次发布：2026-04-05T06:45:20.090Z
- 最新版本发布：2026-10-06T03:01:06.443Z
- 近 30 天下载量：5281（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

CodeGraph MCP服务器——有42个工具,38个语言的跨语言代码智能

## 安装

```sh
npm install @astudioplus/codegraph-mcp
```

也可以使用：`pnpm add @astudioplus/codegraph-mcp`、`yarn add @astudioplus/codegraph-mcp`、`bun add @astudioplus/codegraph-mcp`

## README

# 代码Graph MCP 服务器

AI特工的跨语言代码情报——42个工具,38个语言,持续内存,文档情报,一次性公关审查.

## 安装

```bash
npm install -g @astudioplus/codegraph-mcp
```

分析引擎没有被捆绑在包里. 安装从 GitHub 发布时为您的平台所建的引擎 - 标记为 _发动机_ 版本, npm 唯一的补丁发布不会 移动 - 并验证它与出版 `.sha256` 在安装前 (在Windows上,ONNX运行时的副车也随之而来).

下载失败不会失败安装, 因为 CLI、 钩和 文件都还在工作 - 它会打印一个警告。 重试用 :

```bash
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-mcp` a. 默认发射;或
-   点 `CODEGRAPH_SERVER_PATH` 在引擎 它已经住的地方。 这个 胜过被捆绑的道路 `codegraph-mcp` 缺少清晰的消息失败 而不是倒下 如果什么都没有.

## 使用量

### 克劳德代码

添加为 `~/.claude.json`数字 :

```json
{
  "mcpServers": {
    "codegraph": {
      "command": "codegraph-mcp",
      "args": []
    }
  }
}
```

### Cursor / Windsurf / Cline / 其他 MCP 客户端

同样的配置—— `codegraph-mcp` 命令以 MCP (stdio) 模式启动服务器.

### 选项

后传出旗帜 `--`数字 :

```json
{
  "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工具,其内容如下:

→ **[用于代理的代码规则](https://github.com/codegraph-ai/codegraph-rules-for-agents)**

### GitHub 动作——自动公关审查

获取一个代码分析评论 每一个PR——爆炸半径,测试漏洞, 过时的文件,推荐的审查者。 运行 **只有图表** (没有嵌入,没有) API 密钥, 只是 `GITHUB_TOKEN`) (中文(简体) ). 核心援引:

```bash
codegraph-server --graph-only \
  --run-tool codegraph_pr_context \
  --tool-args '{"baseBranch":"main","format":"markdown"}'
```

这个打印出一个即时的标记下 PR 注释 。 复制复制工作流程 模板存在于 [`.github/workflows/codegraph-pr.yml`](https://github.com/codegraph-ai/CodeGraph/blob/main/.github/workflows/codegraph-pr.yml) 在主重播时.

### 可选: Claude 代码中的自动上下文注射

安装一个 PreTooLUS 钩子, 使 Claude 能够获取图表上下文(`get_edit_context`, (中文(简体) ), `analyze_impact`在索引工作空间中编辑源文件之前。 跳过非源文件并静默地编辑 。 从不阻断工具呼叫.

```bash
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 图像](https://github.com/codegraph-ai/CodeGraph)

## 常见问题

### @astudioplus/codegraph-mcp 是什么？

CodeGraph MCP服务器——有42个工具,38个语言的跨语言代码智能

### 如何安装 @astudioplus/codegraph-mcp？

在项目目录运行 npm install @astudioplus/codegraph-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 codegraph-mcp、codegraph-daemon、codegraph-mcp-fetch-engine、codegraph-mcp-install-hooks，可以用 npx codegraph-mcp 直接运行。

### @astudioplus/codegraph-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/astudioplus\_\_codegraph-mcp 是否存在。

### @astudioplus/codegraph-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @astudioplus/codegraph-mcp 可以商用吗？

@astudioplus/codegraph-mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @astudioplus/codegraph-mcp 的下载量有多少？

根据 npm 官方下载统计，@astudioplus/codegraph-mcp 在 2026/10/07 – 2026/11/05 这 30 天内被下载 5,281 次，日均约 176 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @astudioplus/codegraph-mcp 还在维护吗？

最新版本 0\.21\.0 发布于 2026/10/06（1 个月前）；至今共发布 26 个版本，其中过去 12 个月发布了 26 个；首次发布于 2026/04/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。