MCP Code Graph

Analiza y visualiza grafos de código usando CodeGPT.

Documentación

Servidor MCP Deep Graph por CodeGPT

Un servidor Model Context Protocol que permite una interacción fluida con Code Graphs.

Cómo funciona

Este MCP te permite interactuar con grafos de conocimiento disponibles en tu cuenta de CodeGPT o con grafos públicos de DeepGraph.

Para crear un grafo desde cualquier repositorio de GitHub, simplemente cambia la URL de github.com a deepgraph.co. Por ejemplo:

Repositorio de GitHub: https://github.com/username/repo
URL de DeepGraph: https://deepgraph.co/username/repo

Podrás usar estas consultas avanzadas basadas en grafos en diferentes hosts MCP como ChatGPT, Cursor, Windsurf, CodeGPT Extension, GitHub Copilot, Claude Desktop, Claude Code, Gemini CLI, y otros.

Herramientas disponibles

list-graphs: Muestra los grafos de repositorios disponibles con información básica.
get-code: Recupera el código fuente completo de una funcionalidad específica del grafo.
find-direct-connections: Explora las relaciones directas de una funcionalidad dentro del grafo de código.
nodes-semantic-search: Busca semánticamente funcionalidades de código usando lenguaje natural.
docs-semantic-search: Busca semánticamente la documentación del repositorio.
get-usage-dependency-links: Analiza y lista las funcionalidades afectadas por cambios en una entidad de código.
folder-tree-structure: Recupera la estructura de árbol de una carpeta en el repositorio.

Para grafos de código públicos (sin necesidad de cuenta)

Puedes interactuar con grafos públicos de DeepGraph:

Encuentra cualquier repositorio público en deepgraph.co
Usa la referencia del repositorio (por ejemplo, username/repository-name)

Instalación usando npx

Añade la siguiente configuración a tu 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 (requiere cuenta de CodeGPT)

Antes de usar el servidor MCP de CodeGPT con grafos privados, asegúrate de tener:

Una cuenta de CodeGPT (regístrate en app.codegpt.co)
Un repositorio subido a Code Graph
Obtén tu clave API desde la página de API Keys de CodeGPT (requerida).
Obtén tu ID de organización (opcional) e ID de grafo (opcional).

Instalación con npx

Añade la siguiente configuración a tu 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"
        ]
      }
   }
}

Proveedores CLI

Añadir a Gemini CLI

Añade la configuración JSON a tu archivo settings.json:

Gemini CLI usa archivos settings.json para la configuración persistente. Hay dos ubicaciones para estos archivos:

Archivo de configuración de usuario: Ubicación: ~/.gemini/settings.json (donde ~ es tu directorio de inicio). Alcance: Se aplica a todas las sesiones de Gemini CLI para el usuario actual.
Archivo de configuración del proyecto: Ubicación: .gemini/settings.json dentro del directorio raíz de tu proyecto. Alcance: Se aplica solo al ejecutar Gemini CLI desde ese proyecto específico. La configuración del proyecto anula la configuración de usuario.

Añadir a Claude Code

Sigue estos pasos para integrar Deep Graph MCP Server con Claude Code.

Configuración 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 compartir en equipo, agrega el flag -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

Verificación

# Verify installation
claude mcp list

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

Flujos de trabajo avanzados con comandos personalizados de Claude Code

Claude Code admite comandos slash personalizados que combinan múltiples herramientas de MCP Code Graph para flujos de análisis completos.

Configuración

Copia el directorio de comandos de este repositorio a la raíz de tu proyecto:

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

Haz commit al git de tu proyecto:

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

Comandos disponibles

Comandos de análisis de todo el repositorio (sin necesidad 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 (requieren 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

Ejemplos de uso

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

📈 Historial de estrellas

Soporte

Para soporte y comentarios:

Correo: support@codegpt.co
Sitio web: app.codegpt.co

Licencia

Licencia MIT