Trae 中配置 codegraph MCP

前置知识

MCP 是什么？

MCP（Model Context Protocol）是 AI IDE 的"插件协议"。它让 IDE 通过标准输入输出（stdio）与后台独立进程通信，为 AI 扩展新能力。每个 MCP 服务都按 启动 → 握手 → 列举工具 → Connected 的流程完成加载。

codegraph 是什么？

codegraph 是一个代码分析工具，支持语义搜索、调用链追踪、源码浏览。它有 两种运行模式，这一点非常关键：

模式	命令	行为
CLI 交互模式	`npx @colbymchenry/codegraph`	等待键盘输入，人工交互
MCP 服务模式	`npx @colbymchenry/codegraph serve --mcp`	通过 stdio 响应 MCP 协议，无人值守

作为 MCP 集成时，必须使用服务模式，否则 IDE 会一直转圈等待。

配置步骤

Step 1：打开配置文件

配置文件路径（Windows）：

makefile 复制代码

C:\Users\你的用户名\AppData\Roaming\Trae CN\User\mcp.json

在 Trae IDE 中也可以直接打开这个文件编辑。

Step 2：添加 codegraph 配置

在 mcpServers 中添加：

perl 复制代码

{
  "mcpServers": {
    "codegraph": {
      "command": "npx",
      "args": [
        "-y",
        "@colbymchenry/codegraph",
        "serve",
        "--mcp"
      ],
      "cwd": "${workspaceFolder}",
      "env": {}
    }
  }
}

Step 3：参数说明

参数	归属	作用
`-y`	npx	跳过安装确认，首次自动安装依赖
`serve`	codegraph	以服务模式运行（非交互式 CLI）
`--mcp`	codegraph	使用 MCP 协议通信（非 CLI 协议）
`cwd: "${workspaceFolder}"`	Trae	工作目录设为项目根目录，codegraph 分析此路径下的代码

cwd 已指定项目路径，无需再传 --path 参数。

Step 4：重启 Trae IDE

改完配置后，重启 Trae IDE 让新配置生效。

验证

两种方式确认 codegraph 是否加载成功：

方式一：MCP 管理面板

重启后，在 Trae 的 MCP 管理面板中查看 codegraph 状态，应显示 4 个可用工具：

工具	能力
`codegraph_search`	语义搜索代码符号
`codegraph_callers`	查找函数/方法的调用者
`codegraph_node`	查看符号详情和源码
`codegraph_explore`	探索代码区域结构

方式二：对话测试

直接在对话中让 AI 调用 codegraph：

用 codegraph 搜索一下 vite config

返回正常结果即表示配置成功。

常见问题

为什么 IDE 一直转圈？

几乎都是 codegraph 的参数写错了，常见错误：

json 复制代码

// ❌ 错误：缺少 serve 和 --mcp，进入了 CLI 交互模式，无人值守
"args": ["-y", "@colbymchenry/codegraph"]

// ✅ 正确：以 MCP 服务模式运行
"args": ["-y", "@colbymchenry/codegraph", "serve", "--mcp"]

排查方法：打开日志 AppData\Roaming\Trae CN\logs\最新日期\windowX\exthost\mcp-servers-host.log，如果 codegraph 没有打印 Connected，说明参数有问题。

怎么看日志确认加载成功？

日志中成功的 codegraph 应有类似以下行：

arduino 复制代码

Server running on stdio     ← 进程启动
Got tools: xxx, xxx         ← 工具列表返回
Connected.                  ← 握手完成

三行齐全才表示正常。