<hr>

Deep Graph MCP Server by CodeGPT

A Model Context Protocol server that enables seamless interaction with Code Graphs.

<img width="1373" alt="Screenshot 2025-06-11 at 14 01 15" src="https://github.com/user-attachments/assets/a588bafc-d5a8-4955-8d48-3addaf3ed71c" />

How this works

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

<video src="https://github.com/user-attachments/assets/31f60fe6-6da4-4c67-a845-031908476351" controls autoplay></video>

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.

Available Tools

• 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.

For Public Code Graphs (No Account Required)

You can interact with public graphs from DeepGraph:

1. Find any public repository on deepgraph.co
2. Use the repository reference (e.g., username/repository-name)

Installation using npx

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
        ]
      }
   }
}

For Private Graphs (CodeGPT Account Required)

Before using the CodeGPT MCP Server with private graphs, ensure you have:

1. A CodeGPT account (sign up at app.codegpt.co)
2. Uploaded a repository to Code Graph
3. Get your API Key from CodeGPT API Keys page (required).
4. Get your Organization ID (optional) and Graph ID (optional).

Installation with npx

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",
         "CODEGPT_ORG_ID",
         "CODEGPT_GRAPH_ID"
        ]
      }
   }
}

CLI Providers

Adding to Gemini CLI

Add the JSON configuration to your settings.json file:

<video src="https://github.com/user-attachments/assets/22f601dd-0564-46ac-8973-161de3017e34" controls autoplay></video>

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.

Adding to Claude Code

Follow these steps to integrate Deep Graph MCP Server with Claude Code.

Quick Setup

For Private Graphs

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

For Public Graphs

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 CODEGPT_ORG_ID CODEGPT_GRAPH_ID
# or for public graphs
claude mcp add -s project "Deep Graph MCP" npx -- -y mcp-code-graph@latest username/repository-name username2/repository-name

Verification

# Verify installation
claude mcp list

# Get server details
claude mcp get "Deep Graph MCP"

Advanced Workflows with Claude Code Custom Commands

Claude Code supports custom slash commands that combine multiple MCP Code Graph tools for comprehensive analysis workflows.

Setup

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"

Available Commands

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

Usage Examples

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

📈 Star History

Support

For support and feedback:

• Email: support@codegpt.co
• Website: app.codegpt.co

License

MIT License