# CodeGraph 项目级 MCP 示例

插件 **不再** 通过 `plugin.json` / `.mcp.json` 强制注入 CodeGraph MCP。业务仓须自行配置项目级 MCP，再建立索引。

## 1. 复制配置

| IDE | 示例文件 | 复制到业务仓 |
|-----|----------|--------------|
| Claude Code | `claude.mcp.json` | 仓库根目录 `.mcp.json` |
| Cursor | `cursor.mcp.json` | `.cursor/mcp.json` |

已安装 `kb-workflow` 时，示例位于：

```text
${PI_KB_ROOT}/bootstrap/examples/mcp/
```

示例含 `CODEGRAPH_MCP_TOOLS=explore,status,search,callers,callees,impact,node,files`（explore 优先；不含已废弃的 `context`）。

## 2. 建立索引

在业务仓根目录：

```bash
npx -y @colbymchenry/codegraph@1.5.0 init
npx -y @colbymchenry/codegraph@1.5.0 index
```

将 `.codegraph/` 加入 `.gitignore`。

## 3. 生效与门禁

1. Cursor：**Developer: Reload Window**；Claude Code：重启会话或按 IDE 要求重载 MCP。
2. 确认工具 `codegraph_*`（至少 `codegraph_explore`）可用。
3. 机器门禁：

```bash
node "${PI_KB_ROOT}/scripts/kb-codegraph-check.mjs" --target "$(pwd)"
```

## 4. 两种启动方式

示例默认使用 **npx 直连**（不依赖 `PI_KB_ROOT`）。若已安装本插件且希望复用跨平台 launcher，可将 `command`/`args` 改为：

```json
{
  "command": "node",
  "args": ["${PI_KB_ROOT}/scripts/codegraph-mcp.cjs"]
}
```

（Cursor 项目级配置若无 `PI_KB_ROOT`，请改用绝对路径指向已安装插件的 `scripts/codegraph-mcp.cjs`，或继续用 npx 示例。）

细则：`plugin/skills/kb-workflow/references/kb-codegraph.md`。