深度图代码MCP服务器 Deep Graph MCP Server

Deep Graph MCP Server是一个Model Context Protocol (MCP) 服务器，能将代码库转化为可交互的知识图谱，使开发者能够通过ChatGPT、GitHub Copilot、Claude等多种AI平台，利用自然语言对代码进行高级图谱查询和分析。Deep Graph MCP Server核心功能包括获取特定代码功能的完整源代码、探索代码内部的功能直接关联、对代码功能和项目文档进行语义搜索，分析代码实体变更所影响的功能依赖关系，支持通过自定义命令实现全面的项目级分析工作流，如自动化架构概览、安全审计、技术债务评估、性能优化和智能迁移规划，极大地增强了代码理解与交互能力。

通过Deep Graph MCP Server，用户可与CodeGPT账户中的知识图谱，或DeepGraph的公共图谱交互。

Deep Graph MCP Server可用工具

• list-graphs：列出可用的仓库图谱及基本信息。

• get-code：从图谱中获取特定功能的完整源代码。

• find-direct-connections：探索代码图谱中某功能的直接关联。

• nodes-semantic-search：用自然语言语义搜索代码功能。

• docs-semantic-search：语义搜索仓库文档。

• get-usage-dependency-links：分析并列出受代码实体变更影响的功能。

• folder-tree-structure：获取仓库中某文件夹的树形结构。

Deep Graph MCP Server安装配置

公共图谱（无需账户）

用户可与DeepGraph的公共图谱交互。找到deepgraph.co上的任意公共仓库，使用仓库引用（如username/repository-name），在MCP客户端中添加以下配置：

{
   "mcpServers": {
      "Deep Graph MCP": {
         "command": "npx",
         "args": ["-y" , "mcp-code-graph@latest",
         "username/repository-name",  // DeepGraph仓库URL
         "username2/repository-name2" // 可添加更多仓库
        ]
      }
   }
}

私有图谱（需CodeGPT账户）

使用私有图谱前，需准备：

• 一个CodeGPT账户（可在app.codegpt.co注册）

• 已上传到Code Graph的仓库

• 从CodeGPT API Keys页面获取的API密钥（必填）

• 组织ID（可选）和图谱ID（可选）

在MCP客户端中添加以下配置：

{
   "mcpServers": {
      "Deep Graph MCP": {
         "command": "npx",
         "args": ["-y" , "mcp-code-graph@latest",
         "CODEGPT_API_KEY", // 必填
         "CODEGPT_ORG_ID", // 可选
         "CODEGPT_GRAPH_ID" // 可选
        ]
      }
   }
}

CLI集成

Gemini CLI

需将JSON配置添加到settings.json文件。配置文件有两个位置：

• 用户设置文件：位置为/.gemini/settings.json（为用户主目录），适用于当前用户的所有Gemini CLI会话。

• 项目设置文件：位置为项目根目录下的.gemini/settings.json，仅在该项目中运行Gemini CLI时生效，且会覆盖用户设置。

Claude Code

快速设置

私有图谱：

claude mcp add "Deep Graph MCP" npx -- -y mcp-code-graph@latest CODEGPT_API_KEY

公共图谱：

claude mcp add "Deep Graph MCP" npx -- -y mcp-code-graph@latest username/repository-name

团队共享可添加-s project标志：

claude mcp add -s project "Deep Graph MCP" npx -- -y mcp-code-graph@latest CODEGPT_API_KEY
# 公共图谱
claude mcp add -s project "Deep Graph MCP" npx -- -y mcp-code-graph@latest username/repository-name username2/repository-name

验证

# 验证安装
claude mcp list

# 获取服务器详情
claude mcp get "Deep Graph MCP"

Claude Code自定义命令

Claude Code支持自定义斜杠命令，可组合多个MCP代码图谱工具实现综合分析工作流。

设置

将仓库中的commands目录复制到项目根目录：

cp -r .claude/ /path/to/your/project/

提交到项目的git：

git add .claude/commands/
git commit -m "Add custom Claude Code commands for Deep Graph MCP"

可用命令

无需参数的仓库级分析命令：

• /project:analyze-architecture：完整架构概述

• /project:security-audit：全面安全分析

• /project:test-coverage-analyzer：测试覆盖率和质量分析

• /project:technical-debt-analyzer：技术债务评估

• /project:api-ecosystem-analyzer：完整API生态系统分析

• /project:repository-onboarding：完整仓库入门指南

需要参数的组件特定命令：

• /project:migration-planner [component/technology]：智能迁移规划

• /project:performance-optimizer [component/function]：性能优化

• /project:component-onboarding [component/feature]：组件特定培训

使用示例

/project:analyze-architecture
/project:migration-planner React to Vue.js
/project:performance-optimizer DatabaseService.getUserData
/project:component-onboarding authentication system