前置知识

MCP是 AI IDE 的“插件协议”。说起来，它让 IDE 通过标准输入输出与后台独立进程通信。为 AI 新能力，每个 MCP 服务都按 启动 → 握手 → 列举工具 → Connected 的流程完成加载。

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

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

配置步骤

Step 1：打开配置文件

Pain Point：很多同学不知道配置文件到底在哪儿，导致改了别的文件却无效。

配置文件方法的观点是，

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

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

Step 2：添加 codegraph 配置

在 JSON 根对象的 "mcpServers" 中加入以下块：

{
"mcpServers": {
"codegraph": {
"command": "npx","args":,"cwd": "${workspaceFolder}"。"env": {}
}
}
}

Step 3：参数说明

Step 4：重启 Trae IDE

保存完 mcp.json 后需要彻底关闭并重新打开 Trae IDE，让新配置生效。

验证是否成功加载 Codegraph

说到方式一，MCP 管理面板检查状态 ✅​

• 重启后打开「MCP 管理面板」。
• `Codegraph` 条目应显示「已连接」并列出可用工具。

c odegra ph_ c allers<

/c odeg raph _ n o de<

/c odeg raph_ex plore<

方式二这方面。 对话框直接调用 🗨️​

If AI returns a list of matching symbols or files,integration works.

常见问题 & 疼点排查教程 🛠️​

IDE 一直转圈？🚨​

• **根本原因**：Codegraph 启动参数错误，进入了交互式 CLI 模式。
• **错误示例**：

  // ❌ 缺少 serve 和 --mcp，进入了 CLI 模式
  再看"args"，**正确示例**：
  json
  // ✅ 正确：以 MCP 服务模式运行
  再看"args"，
  
  **排查步骤**：
  
  
  说到打开日志文件。
  C:\Users\你的使用者名\AppData\Roaming\Trae CN\logs\<最新日期>\windowX\exthost\mcp-servers-host.log
  
  搜索关键字 “Connected”。若未出现，则说明启动参数仍有误。
  
  
  
  
  

找不到或看不懂日志？📄​

The log is fastest way to confirm wher Codegraph 完成了握手。成功日志应该包含三行关键字：

• / Server running on stdio ←进程启动 Got tools: xxx。xxx ← 工具列表返回 Connected. ← 握手完成​
  Pain Point: 很多新人只看到 “Server running on stdio”，误以为已经成功，其实还缺少后两行。

搜索结果为空或功能缺失？🔎​

• 确认 **cwd** 指向的是项目根目录；若指向空目录会导致所有工具返回空集合。
• 确保网络环境能够访问 NPM 注册表，因为首次启动时会自动下载依赖。其实，如果下载失败，请手动执行：

  npm i -g @colbymchenry/codegraph
  
  检查是否有防火墙或安全软件拦截了子进程的 stdio 通信。关闭相关拦截后重新启动 IDE 即可。
  

*以上内容已根据使用者常见痛点进行重新排版与强调，帮助快速定位并解决配置过程中的阻塞点。*