Deep Graph MCP Server by CodeGPT
A Model Context Protocol server that enables seamless interaction with Code Graphs.

This MCP allows you to interact with knowledge graphs available in your CodeGPT account or with public graphs from DeepGraph.
To create a graph from any GitHub repository, simply change the URL from github.com
to deepgraph.co
. For example:
- GitHub repo:
https://github.com/username/repo
- DeepGraph URL:
https://deepgraph.co/username/repo
Untitled.design.mp4
You'll be able to use these advanced graph-based queries across different MCP Hosts such as ChatGPT, Cursor, Windsurf, CodeGPT Extension, GitHub Copilot, Claude Desktop, Claude Code, Gemini CLI, and others.
-
list-graphs
: Lists available repository graphs with basic information. -
get-code
: Retrieves the complete source code for a specific functionality from the graph. -
find-direct-connections
: Explores the direct relationships of a functionality within the code graph. -
nodes-semantic-search
: Semantically searches for code functionalities using natural language. -
docs-semantic-search
: Semantically searches repository documentation. -
get-usage-dependency-links
: Analyzes and lists functionalities affected by changes to a code entity. -
folder-tree-structure
: Retrieves the tree structure of a folder in the repository.
You can interact with public graphs from DeepGraph:
- Find any public repository on deepgraph.co
- Use the repository reference (e.g.,
username/repository-name
)
Add the following configuration to your MCP client (CodeGPT Extension, Cursor, Copilot, Claude Desktop, Windsurf, etc.):
{
"mcpServers": {
"Deep Graph MCP": {
"command": "npx",
"args": ["-y" , "mcp-code-graph@latest",
"username/repository-name", // DeepGraph repository URL
"username2/repository-name2" // Add more repositories if needed
]
}
}
}
Before using the CodeGPT MCP Server with private graphs, ensure you have:
- A CodeGPT account (sign up at app.codegpt.co)
- Uploaded a repository to Code Graph
- Get your API Key from CodeGPT API Keys page (required).
- Get your Organization ID (optional) and Graph ID (optional).
Add the following configuration to your MCP client (CodeGPT Extension, Cursor, Copilot, Claude Desktop, Windsurf, etc.):
{
"mcpServers": {
"Deep Graph MCP": {
"command": "npx",
"args": ["-y" , "mcp-code-graph@latest",
"CODEGPT_API_KEY", // Required
"CODEGPT_ORG_ID", // Optional
"CODEGPT_GRAPH_ID" // Optional
]
}
}
}
Add the JSON configuration to your settings.json file:
Untitled.design.1.mp4
Gemini CLI uses settings.json files for persistent configuration. There are two locations for these files:
-
User settings file: Location: ~/.gemini/settings.json (where ~ is your home directory). Scope: Applies to all Gemini CLI sessions for the current user.
-
Project settings file: Location: .gemini/settings.json within your project's root directory. Scope: Applies only when running Gemini CLI from that specific project. Project settings override user settings.
Follow these steps to integrate Deep Graph MCP Server with 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
For team sharing, add the -s project
flag:
claude mcp add -s project "Deep Graph MCP" npx -- -y mcp-code-graph@latest CODEGPT_API_KEY
# or for public graphs
claude mcp add -s project "Deep Graph MCP" npx -- -y mcp-code-graph@latest username/repository-name username2/repository-name
# Verify installation
claude mcp list
# Get server details
claude mcp get "Deep Graph MCP"
Claude Code supports custom slash commands that combine multiple MCP Code Graph tools for comprehensive analysis workflows.
Copy the commands directory from this repository to your project root:
cp -r .claude/ /path/to/your/project/
Commit to your project's git:
git add .claude/commands/
git commit -m "Add custom Claude Code commands for Deep Graph MCP"
Repository-wide analysis commands (no parameters needed):
/project:analyze-architecture # Complete architectural overview
/project:security-audit # Comprehensive security analysis
/project:test-coverage-analyzer # Test coverage and quality analysis
/project:technical-debt-analyzer # Technical debt assessment
/project:api-ecosystem-analyzer # Complete API ecosystem analysis
/project:repository-onboarding # Full repository onboarding guide
Component-specific commands (require parameters):
/project:migration-planner [component/technology] # Smart migration planning
/project:performance-optimizer [component/function] # Performance optimization
/project:component-onboarding [component/feature] # Component-specific training
/project:analyze-architecture
/project:migration-planner React to Vue.js
/project:performance-optimizer DatabaseService.getUserData
/project:component-onboarding authentication system
For support and feedback:
- Email: [email protected]
- Website: app.codegpt.co