MCP Code Graph
Analise e visualize grafos de código usando CodeGPT.
Documentação
Servidor MCP Deep Graph por CodeGPT
Um servidor Model Context Protocol que permite interação perfeita com Code Graphs.
Como funciona
Este MCP permite que você interaja com grafos de conhecimento disponíveis na sua conta CodeGPT ou com grafos públicos do DeepGraph.
Para criar um grafo a partir de qualquer repositório GitHub, basta alterar a URL de github.com para deepgraph.co. Por exemplo:
- Repositório GitHub:
https://github.com/username/repo - URL DeepGraph:
https://deepgraph.co/username/repo
Você poderá usar essas consultas avançadas baseadas em grafos em diferentes hosts MCP, como ChatGPT, Cursor, Windsurf, CodeGPT Extension, GitHub Copilot, Claude Desktop, Claude Code, Gemini CLI e outros.
Ferramentas disponíveis
-
list-graphs: Lista os grafos de repositórios disponíveis com informações básicas. -
get-code: Recupera o código-fonte completo de uma funcionalidade específica do grafo. -
find-direct-connections: Explora as relações diretas de uma funcionalidade dentro do grafo de código. -
nodes-semantic-search: Busca semanticamente por funcionalidades de código usando linguagem natural. -
docs-semantic-search: Busca semanticamente na documentação do repositório. -
get-usage-dependency-links: Analisa e lista funcionalidades afetadas por alterações em uma entidade de código. -
folder-tree-structure: Recupera a estrutura de árvore de uma pasta no repositório.
Para Grafos de Código Públicos (Sem Necessidade de Conta)
Você pode interagir com grafos públicos do DeepGraph:
- Encontre qualquer repositório público em deepgraph.co
- Use a referência do repositório (ex.:
username/repository-name)
Instalação usando npx
Adicione a seguinte configuração ao seu cliente MCP (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
]
}
}
}
Para Grafos Privados (Conta CodeGPT Necessária)
Antes de usar o servidor MCP CodeGPT com grafos privados, certifique-se de ter:
- Uma conta CodeGPT (cadastre-se em app.codegpt.co)
- Enviado um repositório para Code Graph
- Obtenha sua chave de API na página de chaves de API do CodeGPT (obrigatório).
- Obtenha seu ID de Organização (opcional) e ID do Grafo (opcional).
Instalação com npx
Adicione a seguinte configuração ao seu cliente MCP (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"
]
}
}
}
Provedores CLI
Adicionando ao Gemini CLI
Adicione a configuração JSON ao seu arquivo settings.json:
O Gemini CLI usa arquivos settings.json para configuração persistente. Há dois locais para esses arquivos:
-
Arquivo de configurações do usuário: Localização: ~/.gemini/settings.json (onde ~ é o seu diretório pessoal). Escopo: Aplica-se a todas as sessões do Gemini CLI para o usuário atual.
-
Arquivo de configurações do projeto: Localização: .gemini/settings.json dentro do diretório raiz do seu projeto. Escopo: Aplica-se somente quando você executa o Gemini CLI a partir desse projeto específico. As configurações do projeto substituem as configurações do usuário.
Adicionando ao Claude Code
Siga estas etapas para integrar o servidor MCP Deep Graph ao Claude Code.
Configuração Rápida
Para Grafos Privados
claude mcp add "Deep Graph MCP" npx -- -y mcp-code-graph@latest CODEGPT_API_KEY CODEGPT_ORG_ID CODEGPT_GRAPH_ID
Para Grafos Públicos
claude mcp add "Deep Graph MCP" npx -- -y mcp-code-graph@latest username/repository-name
Para compartilhamento em equipe, adicione o sinalizador -s project:
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
Verificação
# Verify installation
claude mcp list
# Get server details
claude mcp get "Deep Graph MCP"
Fluxos de Trabalho Avançados com Comandos Personalizados do Claude Code
O Claude Code suporta comandos de barra personalizados que combinam várias ferramentas do MCP Code Graph para fluxos de análise abrangentes.
Configuração
Copie o diretório de comandos deste repositório para a raiz do seu projeto:
cp -r .claude/ /path/to/your/project/
Envie para o git do seu projeto:
git add .claude/commands/
git commit -m "Add custom Claude Code commands for Deep Graph MCP"
Comandos Disponíveis
Comandos de análise em todo o repositório (sem necessidade de parâmetros):
/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
Comandos específicos de componentes (exigem parâmetros):
/project:migration-planner [component/technology] # Smart migration planning
/project:performance-optimizer [component/function] # Performance optimization
/project:component-onboarding [component/feature] # Component-specific training
Exemplos de Uso
/project:analyze-architecture
/project:migration-planner React to Vue.js
/project:performance-optimizer DatabaseService.getUserData
/project:component-onboarding authentication system
📈 Histórico de Estrelas
Suporte
Para suporte e feedback:
- E-mail: support@codegpt.co
- Site: app.codegpt.co