graphmycode-mcp 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,10 @@
 # graphmycode-mcp
 
-MCP server for codebase structure analysis. Provides dependency graphs, community detection, hotspot identification, and agent context generation directly inside Claude Code.
+[![npm version](https://img.shields.io/npm/v/graphmycode-mcp)](https://www.npmjs.com/package/graphmycode-mcp)
+
+MCP server for codebase structure analysis. Provides dependency graphs, community detection, hotspot identification, and agent context generation.
+
+Works with **Claude Code, Cursor, Windsurf, Cline, Continue, Zed, and Google Antigravity**.
 
 ## Install
 
@@ -8,32 +12,38 @@ MCP server for codebase structure analysis. Provides dependency graphs, communit
 npm install -g graphmycode-mcp
 ```
 
-The postinstall script automatically:
-1. Registers the MCP server in Claude Code (`~/.claude/claude.json`)
-2. Installs 8 slash commands in `~/.claude/commands/`
+The postinstall script automatically registers the MCP server in **Claude Code** and installs 9 slash commands.
+
+To register in other editors, run:
 
-Restart Claude Code after installing to activate.
+```bash
+graphmycode-mcp setup --all          # all supported editors
+graphmycode-mcp setup cursor         # Cursor only
+graphmycode-mcp setup windsurf       # Windsurf only
+graphmycode-mcp setup cline          # Cline (VSCode) only
+graphmycode-mcp setup continue       # Continue only
+graphmycode-mcp setup zed            # Zed only
+graphmycode-mcp setup antigravity    # Google Antigravity only
+```
+
+Restart your editor(s) after setup.
 
 ---
 
-### If the postinstall was skipped
+## Manual configuration per editor
+
+If you prefer to configure manually, add the following snippet to each editor's config file.
 
-This happens when installing with `--ignore-scripts` or in CI environments. Run setup manually:
+### Claude Code
 
 ```bash
-graphmycode-mcp setup
+claude mcp add -s user graphmycode -- node $(npm root -g)/graphmycode-mcp/dist/index.js
 ```
 
----
-
-### Manual registration (clone/dev install)
-
-If you cloned the repo instead of installing from npm:
+Or if you cloned the repo:
 
 ```bash
-npm install
-npm run build
-node_path=$(which node)   # get absolute path — e.g. /opt/homebrew/bin/node
+node_path=$(which node)
 dist_path=$(pwd)/dist/index.js
 claude mcp add -s user graphmycode -- "$node_path" "$dist_path"
 ```
@@ -44,6 +54,102 @@ Then copy the slash commands:
 cp commands/*.md ~/.claude/commands/
 ```
 
+### Cursor
+
+File: `~/.cursor/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "graphmycode": {
+      "command": "npx",
+      "args": ["-y", "graphmycode-mcp"]
+    }
+  }
+}
+```
+
+### Windsurf
+
+File: `~/.codeium/windsurf/mcp_config.json`
+
+```json
+{
+  "mcpServers": {
+    "graphmycode": {
+      "command": "npx",
+      "args": ["-y", "graphmycode-mcp"]
+    }
+  }
+}
+```
+
+### Cline (VSCode extension)
+
+Open **Cline → MCP Servers → Configure MCP Servers** and add:
+
+```json
+{
+  "mcpServers": {
+    "graphmycode": {
+      "command": "npx",
+      "args": ["-y", "graphmycode-mcp"],
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+### Continue
+
+Create the file `~/.continue/mcpServers/graphmycode.json`:
+
+```json
+{
+  "mcpServers": {
+    "graphmycode": {
+      "command": "npx",
+      "args": ["-y", "graphmycode-mcp"]
+    }
+  }
+}
+```
+
+Continue automatically picks up JSON files from `~/.continue/mcpServers/`.
+
+### Google Antigravity
+
+File: `~/.gemini/config/mcp_config.json` (macOS/Linux)
+File: `C:\Users\<USER>\.gemini\antigravity\mcp_config.json` (Windows)
+
+```json
+{
+  "mcpServers": {
+    "graphmycode": {
+      "command": "npx",
+      "args": ["-y", "graphmycode-mcp"]
+    }
+  }
+}
+```
+
+### Zed
+
+File: `~/.config/zed/settings.json`
+
+```json
+{
+  "context_servers": {
+    "graphmycode-mcp": {
+      "source": "custom",
+      "command": "npx",
+      "args": ["-y", "graphmycode-mcp"]
+    }
+  }
+}
+```
+
 ---
 
 ## Tools
@@ -58,9 +164,7 @@ cp commands/*.md ~/.claude/commands/
 | `query_graph` | Natural language queries over the graph |
 | `export_agent_context` | Generate `CLAUDE.md` / `AGENTS.md` for the codebase |
 
-## Slash Commands
-
-Once installed, these commands are available in Claude Code:
+## Slash Commands (Claude Code only)
 
 | Command | Description |
 |---------|-------------|
@@ -74,10 +178,14 @@ Once installed, these commands are available in Claude Code:
 | `/graphmycode-semantic` | Module communities and logical duplication |
 | `/graphmycode-structural` | Structural dependency deep-dive |
 
+## Visual interface
+
+For an interactive visual graph of your codebase, visit **[graphmycode.com](https://graphmycode.com)**.
+
 ## Requirements
 
 - Node.js 18+
-- [Claude Code](https://claude.ai/code) CLI installed and configured
+- At least one of: Claude Code, Cursor, Windsurf, Cline, Continue, Zed, or Google Antigravity
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "graphmycode-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for codebase structure analysis — dependency graphs, communities, hotspots, and agent context generation",
   "type": "module",
   "main": "dist/index.js",
@@ -23,6 +23,13 @@
   "keywords": [
     "mcp",
     "claude",
+    "cursor",
+    "windsurf",
+    "cline",
+    "continue",
+    "zed",
+    "antigravity",
+    "google-antigravity",
     "codebase",
     "dependency-graph",
     "code-analysis",

package/scripts/cli.mjs

@@ -1,8 +1,15 @@
 #!/usr/bin/env node
-// Punto de entrada CLI: "graphmycode-mcp setup" o el servidor MCP
-if (process.argv[2] === 'setup') {
-  const { setup } = await import('./setup.mjs');
-  setup();
+const [, , arg, subarg] = process.argv;
+
+if (arg === 'setup') {
+  const { setup, setupTool, setupAll } = await import('./setup.mjs');
+  if (!subarg) {
+    setup();
+  } else if (subarg === '--all') {
+    setupAll();
+  } else {
+    setupTool(subarg);
+  }
 } else {
   await import('../dist/index.js');
 }

package/scripts/setup.mjs

@@ -11,6 +11,8 @@ const nodePath = process.execPath;
 const commandsSource = path.join(packageRoot, 'commands');
 const commandsDest = path.join(os.homedir(), '.claude', 'commands');
 
+// ─── Claude Code ────────────────────────────────────────────────────────────
+
 function registerMcp() {
   try {
     execSync(`claude mcp add -s user graphmycode -- "${nodePath}" "${distPath}"`, {
@@ -20,16 +22,15 @@ function registerMcp() {
   } catch (e) {
     const output = (e.stderr?.toString() ?? '') + (e.stdout?.toString() ?? '');
     if (output.includes('already') || output.includes('exists')) {
-      // Idempotente: ya estaba registrado, actualizar con remove+add
       try {
         execSync('claude mcp remove graphmycode -s user', { stdio: 'pipe' });
         execSync(`claude mcp add -s user graphmycode -- "${nodePath}" "${distPath}"`, { stdio: 'pipe' });
         console.log('✓ MCP graphmycode actualizado en Claude Code');
       } catch {
-        console.log('✓ MCP graphmycode ya estaba registrado');
+        console.log('✓ MCP graphmycode ya estaba registrado en Claude Code');
       }
     } else {
-      console.warn('⚠  No se pudo registrar el MCP automáticamente.');
+      console.warn('⚠  No se pudo registrar el MCP en Claude Code automáticamente.');
       console.warn('   Ejecuta manualmente:');
       console.warn(`   claude mcp add -s user graphmycode -- "${nodePath}" "${distPath}"`);
     }
@@ -49,6 +50,130 @@ function copyCommands() {
   console.log('  ' + files.map((f) => `/${f.replace('.md', '')}`).join(', '));
 }
 
+// ─── Helpers ────────────────────────────────────────────────────────────────
+
+function mergeJsonConfig(filePath, mcpKey, serverConfig) {
+  let config = {};
+  if (fs.existsSync(filePath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    } catch {
+      config = {};
+    }
+  }
+  config.mcpServers = config.mcpServers ?? {};
+  config.mcpServers[mcpKey] = serverConfig;
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n');
+}
+
+const npxEntry = { command: 'npx', args: ['-y', 'graphmycode-mcp'] };
+
+// ─── Cursor ─────────────────────────────────────────────────────────────────
+
+function registerCursor() {
+  const configPath = path.join(os.homedir(), '.cursor', 'mcp.json');
+  mergeJsonConfig(configPath, 'graphmycode', npxEntry);
+  console.log('✓ MCP graphmycode registrado en Cursor (~/.cursor/mcp.json)');
+}
+
+// ─── Windsurf ────────────────────────────────────────────────────────────────
+
+function registerWindsurf() {
+  const configPath = path.join(os.homedir(), '.codeium', 'windsurf', 'mcp_config.json');
+  mergeJsonConfig(configPath, 'graphmycode', npxEntry);
+  console.log('✓ MCP graphmycode registrado en Windsurf (~/.codeium/windsurf/mcp_config.json)');
+}
+
+// ─── Cline ───────────────────────────────────────────────────────────────────
+
+function getClinePath() {
+  const ext = path.join('globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
+  if (process.platform === 'darwin') {
+    return path.join(os.homedir(), 'Library', 'Application Support', 'Code', 'User', ext);
+  }
+  if (process.platform === 'win32') {
+    return path.join(process.env.APPDATA || '', 'Code', 'User', ext);
+  }
+  return path.join(os.homedir(), '.config', 'Code', 'User', ext);
+}
+
+function registerCline() {
+  const configPath = getClinePath();
+  const settingsDir = path.dirname(configPath);
+
+  if (!fs.existsSync(settingsDir)) {
+    console.warn('⚠  Cline: directorio de VSCode no encontrado.');
+    console.warn(`   Ruta esperada: ${configPath}`);
+    console.warn('   Configura manualmente en Cline > MCP Servers > Configure MCP Servers.');
+    return false;
+  }
+
+  mergeJsonConfig(configPath, 'graphmycode', {
+    ...npxEntry,
+    disabled: false,
+    autoApprove: [],
+  });
+  console.log('✓ MCP graphmycode registrado en Cline (VSCode)');
+  return true;
+}
+
+// ─── Continue ────────────────────────────────────────────────────────────────
+
+function registerContinue() {
+  // Continue picks up JSON files from ~/.continue/mcpServers/ automatically
+  const dir = path.join(os.homedir(), '.continue', 'mcpServers');
+  fs.mkdirSync(dir, { recursive: true });
+  const configPath = path.join(dir, 'graphmycode.json');
+  fs.writeFileSync(
+    configPath,
+    JSON.stringify({ mcpServers: { graphmycode: npxEntry } }, null, 2) + '\n',
+  );
+  console.log('✓ MCP graphmycode registrado en Continue (~/.continue/mcpServers/graphmycode.json)');
+}
+
+// ─── Antigravity (Google) ────────────────────────────────────────────────────
+
+function registerAntigravity() {
+  const configPath = process.platform === 'win32'
+    ? path.join(os.homedir(), '.gemini', 'antigravity', 'mcp_config.json')
+    : path.join(os.homedir(), '.gemini', 'config', 'mcp_config.json');
+  mergeJsonConfig(configPath, 'graphmycode', npxEntry);
+  console.log(`✓ MCP graphmycode registrado en Antigravity (${configPath.replace(os.homedir(), '~')})`);
+}
+
+// ─── Zed ─────────────────────────────────────────────────────────────────────
+
+function getZedSettingsPath() {
+  if (process.platform === 'win32') {
+    return path.join(process.env.APPDATA || '', 'Zed', 'settings.json');
+  }
+  return path.join(os.homedir(), '.config', 'zed', 'settings.json');
+}
+
+function registerZed() {
+  const configPath = getZedSettingsPath();
+  let config = {};
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    } catch {
+      config = {};
+    }
+  }
+  config.context_servers = config.context_servers ?? {};
+  config.context_servers['graphmycode-mcp'] = {
+    source: 'custom',
+    command: 'npx',
+    args: ['-y', 'graphmycode-mcp'],
+  };
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+  console.log('✓ MCP graphmycode registrado en Zed (~/.config/zed/settings.json)');
+}
+
+// ─── Exports públicos ────────────────────────────────────────────────────────
+
 export function setup() {
   if (!fs.existsSync(distPath)) {
     console.error('Error: dist/index.js no encontrado. El paquete puede estar corrupto.');
@@ -60,3 +185,33 @@ export function setup() {
   copyCommands();
   console.log('\n¡Listo! Reinicia Claude Code para activar los cambios.\n');
 }
+
+export function setupTool(tool) {
+  console.log(`\nConfigurando GraphMyCode MCP para ${tool}...\n`);
+  switch (tool) {
+    case 'cursor':       registerCursor();      break;
+    case 'windsurf':     registerWindsurf();    break;
+    case 'cline':        registerCline();       break;
+    case 'continue':     registerContinue();    break;
+    case 'zed':          registerZed();         break;
+    case 'antigravity':  registerAntigravity(); break;
+    default:
+      console.error(`Herramienta desconocida: "${tool}"`);
+      console.error('Disponibles: cursor, windsurf, cline, continue, zed, antigravity');
+      process.exit(1);
+  }
+  console.log('\nReinicia el editor para activar los cambios.\n');
+}
+
+export function setupAll() {
+  console.log('\nConfigurando GraphMyCode MCP para todos los editores...\n');
+  registerMcp();
+  copyCommands();
+  registerCursor();
+  registerWindsurf();
+  registerCline();
+  registerContinue();
+  registerZed();
+  registerAntigravity();
+  console.log('\n¡Listo! Reinicia tus editores para activar los cambios.\n');
+}