graphmycode-mcp 0.1.0

package/README.md

@@ -0,0 +1,84 @@
+# graphmycode-mcp
+
+MCP server for codebase structure analysis. Provides dependency graphs, community detection, hotspot identification, and agent context generation directly inside Claude Code.
+
+## Install
+
+```bash
+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/`
+
+Restart Claude Code after installing to activate.
+
+---
+
+### If the postinstall was skipped
+
+This happens when installing with `--ignore-scripts` or in CI environments. Run setup manually:
+
+```bash
+graphmycode-mcp setup
+```
+
+---
+
+### Manual registration (clone/dev install)
+
+If you cloned the repo instead of installing from npm:
+
+```bash
+npm install
+npm run build
+node_path=$(which node)   # get absolute path — e.g. /opt/homebrew/bin/node
+dist_path=$(pwd)/dist/index.js
+claude mcp add -s user graphmycode -- "$node_path" "$dist_path"
+```
+
+Then copy the slash commands:
+
+```bash
+cp commands/*.md ~/.claude/commands/
+```
+
+---
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `analyze_structure` | Full dependency graph with hotspots, dead code, and coupling metrics |
+| `detect_stack` | Languages, frameworks, and project type |
+| `get_file_dependencies` | Imports and importedBy for a specific file |
+| `get_communities` | Module clusters detected via graph analysis |
+| `find_entry_points` | Files with no importers (CLI, main, index) |
+| `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:
+
+| Command | Description |
+|---------|-------------|
+| `/graphmycode` | Hotspots, dead code, coupling summary |
+| `/graphmycode-analysis` | Full analysis cycle with improvement plan |
+| `/graphmycode-context` | Generate CLAUDE.md / AGENTS.md for the codebase |
+| `/graphmycode-debt` | Prioritized technical debt backlog (P1/P2/P3) |
+| `/graphmycode-flow` | Execution flow from entry points |
+| `/graphmycode-heatmap` | Circular dependencies and hotspot heatmap |
+| `/graphmycode-layers` | Architectural layers and violations |
+| `/graphmycode-semantic` | Module communities and logical duplication |
+| `/graphmycode-structural` | Structural dependency deep-dive |
+
+## Requirements
+
+- Node.js 18+
+- [Claude Code](https://claude.ai/code) CLI installed and configured
+
+## License
+
+MIT

package/commands/graphmycode-analysis.md

@@ -0,0 +1,13 @@
+Run a full graphmycode analysis cycle and generate an improvement plan.
+
+1. Call `analyze_structure` with `path` = current working directory
+2. Call `get_communities` with `path` = current working directory
+3. Call `detect_stack` with `path` = current working directory
+4. Call `query_graph` asking "¿cuales son los archivos más acoplados?"
+
+Report:
+- **Current state** — quick metrics snapshot (files, edges, density, avgFanIn/Out)
+- **Top 3 issues** — critical structural problems ranked by impact
+- **Quick wins** — improvements you can make in < 1 hour
+- **Strategic moves** — refactoring priorities for next sprint
+- **Success metrics** — how you'll know the refactoring worked

package/commands/graphmycode-context.md

@@ -0,0 +1,10 @@
+Generate CLAUDE.md and/or AGENTS.md context files for the current codebase.
+
+Use the `export_agent_context` tool with:
+- `path` = current working directory
+- `format` = "both"
+
+Report:
+- **Files generated** — which context files were created and where
+- **Stack summary** — what the generated context captures about the project
+- **Key sections** — highlight the most useful parts written (entry points, dependencies, architecture)

package/commands/graphmycode-debt.md

@@ -0,0 +1,11 @@
+Produce a prioritized technical debt report for the current codebase.
+
+1. Call `analyze_structure` with `path` = current working directory
+2. Call `get_communities` with `path` = current working directory
+3. For each hotspot (top 5 by fanIn), call `get_file_dependencies`
+
+Debt backlog:
+- **P1 (Critical)** — files with fanIn > 10 or involved in cycles
+- **P2 (High)** — files with fanIn 5-10 or communities > 20 files
+- **P3 (Medium)** — dead code candidates, large unfocused communities
+- Include T-shirt size estimates (S/M/L/XL) per item

package/commands/graphmycode-flow.md

@@ -0,0 +1,10 @@
+Trace execution flow from entry points through the current codebase.
+
+1. Call `find_entry_points` with `path` = current working directory
+2. For each high-confidence entry point, call `get_file_dependencies`
+
+Report:
+- **Entry points** — with confidence level and reason
+- **Execution flow** — file chain from each entry point (one level deep)
+- **Dead ends** — entry points that lead to dead code
+- **Flow recommendations** — how to simplify the execution path

package/commands/graphmycode-heatmap.md

@@ -0,0 +1,11 @@
+Detect circular dependencies and dependency hotspots in the current codebase.
+
+1. Call `analyze_structure` with `path` = current working directory
+2. Call `query_graph` asking "¿hay ciclos de importación?"
+3. Call `query_graph` asking "¿qué archivos tienen más dependencias?"
+
+Report:
+- **Circular imports** — each cycle with full file chain
+- **Hotspot heatmap** — top 10 files by fanIn as ranked list
+- **Risk assessment** — which cycles are most dangerous
+- **Fix recommendations** — concrete steps to break each cycle

package/commands/graphmycode-layers.md

@@ -0,0 +1,11 @@
+Analyze the architectural layers of the current codebase.
+
+1. Call `detect_stack` with `path` = current working directory
+2. Call `get_communities` with `path` = current working directory
+3. Call `analyze_structure` with `path` = current working directory
+
+Report:
+- **Stack summary** — languages, frameworks, project type
+- **Architectural layers** — map communities to layers (presentation/business/data/infrastructure)
+- **Layer violations** — edges crossing architectural boundaries in the wrong direction
+- **Architecture recommendations** — improvements to layering

package/commands/graphmycode-semantic.md

@@ -0,0 +1,9 @@
+Analyze logical duplication and semantic clustering in the current codebase.
+
+1. Call `get_communities` with `path` = current working directory
+2. Call `query_graph` asking "what files have the most dependencies?"
+
+Report:
+- **Module communities** — each community with its files and inferred purpose
+- **Potential duplication** — communities with similar names or overlapping deps
+- **Semantic recommendations** — suggest consolidations or renames

package/commands/graphmycode-structural.md

@@ -0,0 +1,9 @@
+Perform structural dependency analysis of the current codebase.
+
+1. Call `analyze_structure` with `path` = current working directory
+2. For the top 3 files by fanIn, call `get_file_dependencies`
+
+Report:
+- **Most depended-on files** with full import/importedBy lists
+- **Bidirectional dependencies** — files that import each other
+- **Structural recommendations** — how to reduce coupling

package/commands/graphmycode.md

@@ -0,0 +1,9 @@
+Analyze the structure of the current codebase using graphmycode MCP.
+
+Use the `analyze_structure` tool with `path` set to the current working directory.
+
+Report:
+1. **Hotspots** — files with highest fanIn, with count
+2. **Dead code candidates** — files with fanIn=0 that are not entry points
+3. **Coupling summary** — avgFanIn, avgFanOut, total edges
+4. **Top recommendations** — refactoring priorities based on metrics

package/dist/analyzer/agent.d.ts

@@ -0,0 +1,7 @@
+import type { DependencyGraph } from './graph.js';
+import type { StackInfo } from './stack.js';
+import type { Community } from './communities.js';
+export declare function generateAgentContext(rootPath: string, graph: DependencyGraph, stack: StackInfo, communities: Map<string, Community>, format: 'CLAUDE.md' | 'AGENTS.md' | 'both'): Promise<Array<{
+    name: string;
+    content: string;
+}>>;

package/dist/analyzer/agent.js

@@ -0,0 +1,99 @@
+import fs from 'fs/promises';
+import path from 'path';
+function inferCommands(stack) {
+    const pm = stack.packageManager;
+    const run = pm === 'yarn' ? 'yarn' : pm === 'pnpm' ? 'pnpm' : pm === 'bun' ? 'bun' : 'npm run';
+    if (stack.languages.includes('python')) {
+        return { install: 'pip install -r requirements.txt', dev: 'python main.py', build: '# N/A', test: 'pytest' };
+    }
+    if (stack.languages.includes('php')) {
+        return { install: 'composer install', dev: 'php artisan serve', build: '# N/A', test: 'phpunit' };
+    }
+    return {
+        install: pm === 'npm' ? 'npm install' : `${pm} install`,
+        dev: `${run} dev`,
+        build: `${run} build`,
+        test: `${run} test`,
+    };
+}
+function buildModuleMap(communities) {
+    return [...communities.values()].map(c => {
+        const files = c.files.slice(0, 3).map(f => `  - ${f}`).join('\n');
+        const more = c.files.length > 3 ? `\n  - ...and ${c.files.length - 3} more` : '';
+        return `- **${c.label}** (${c.size} files)\n${files}${more}`;
+    }).join('\n');
+}
+function buildCriticalEdges(graph) {
+    const top = [...graph.nodes.values()]
+        .filter(n => n.importedBy.length > 0)
+        .sort((a, b) => b.importedBy.length - a.importedBy.length)
+        .slice(0, 5);
+    return top.length > 0
+        ? top.map(n => `- \`${n.id}\` importado por ${n.importedBy.length} archivo(s)`).join('\n')
+        : '(none detected)';
+}
+function buildKeySymbols(graph) {
+    return [...graph.nodes.values()]
+        .sort((a, b) => b.importedBy.length - a.importedBy.length)
+        .slice(0, 8)
+        .map(n => `- \`${path.basename(n.id, path.extname(n.id))}\` (${n.id})`)
+        .join('\n') || '(none detected)';
+}
+async function detectMcpTools(rootPath) {
+    try {
+        const entries = await fs.readdir(path.join(rootPath, '.claude'), { withFileTypes: true });
+        return entries.map(e => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+function generateClaudeMdContent(rootPath, graph, stack, communities) {
+    const name = path.basename(rootPath);
+    const cmds = inferCommands(stack);
+    return `# CLAUDE.md
+
+## Purpose
+${name} — ${stack.projectType} project in ${stack.languages[0] ?? 'unknown'}${stack.frameworks.length ? ` using ${stack.frameworks.slice(0, 2).join(', ')}` : ''}
+
+## Stack
+- Language: ${stack.languages[0] ?? 'unknown'}
+- Frameworks: ${stack.frameworks.join(', ') || 'none detected'}
+- Package manager: ${stack.packageManager}
+- Type: ${stack.projectType}
+
+## Commands
+- Install: \`${cmds.install}\`
+- Dev: \`${cmds.dev}\`
+- Build: \`${cmds.build}\`
+- Test: \`${cmds.test}\`
+
+## Module Map
+${buildModuleMap(communities)}
+
+## Key Symbols
+${buildKeySymbols(graph)}
+
+## Critical Edges
+${buildCriticalEdges(graph)}
+`;
+}
+async function generateAgentsMdContent(rootPath, graph, stack, communities) {
+    const base = generateClaudeMdContent(rootPath, graph, stack, communities);
+    const tools = await detectMcpTools(rootPath);
+    const toolsSection = tools.length > 0
+        ? `\n## Available Tools\n${tools.map(t => `- ${t}`).join('\n')}\n`
+        : '\n## Available Tools\n(none detected in .claude/)\n';
+    return base.replace('# CLAUDE.md', '# AGENTS.md') + toolsSection;
+}
+export async function generateAgentContext(rootPath, graph, stack, communities, format) {
+    const results = [];
+    if (format === 'CLAUDE.md' || format === 'both') {
+        results.push({ name: 'CLAUDE.md', content: generateClaudeMdContent(rootPath, graph, stack, communities) });
+    }
+    if (format === 'AGENTS.md' || format === 'both') {
+        results.push({ name: 'AGENTS.md', content: await generateAgentsMdContent(rootPath, graph, stack, communities) });
+    }
+    return results;
+}
+//# sourceMappingURL=agent.js.map

package/dist/analyzer/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/analyzer/agent.ts"],"names":[],"mappings":"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"}

package/dist/analyzer/communities.d.ts

@@ -0,0 +1,8 @@
+import type { DependencyGraph } from './graph.js';
+export interface Community {
+    id: string;
+    label: string;
+    files: string[];
+    size: number;
+}
+export declare function buildCommunities(graph: DependencyGraph): Map<string, Community>;

package/dist/analyzer/communities.js

@@ -0,0 +1,78 @@
+import path from 'path';
+const DENSITY_THRESHOLD = 0.6;
+export function buildCommunities(graph) {
+    // Paso 1: agrupar por directorio padre
+    const dirGroups = new Map();
+    for (const node of graph.nodes.values()) {
+        const dir = path.dirname(node.id);
+        const key = dir === '.' ? '(root)' : dir;
+        const s = dirGroups.get(key) ?? new Set();
+        s.add(node.id);
+        dirGroups.set(key, s);
+    }
+    // Fusionar directorios con un solo archivo con su padre
+    const groups = [];
+    for (const [dir, files] of dirGroups) {
+        if (files.size === 1 && dir !== '(root)') {
+            const parent = path.dirname(dir);
+            const parentKey = parent === '.' ? '(root)' : parent;
+            const existing = groups.find(g => g.dir === parentKey);
+            if (existing) {
+                for (const f of files)
+                    existing.files.add(f);
+            }
+            else {
+                groups.push({ dir: parentKey, files: new Set(files) });
+            }
+        }
+        else {
+            const existing = groups.find(g => g.dir === dir);
+            if (existing) {
+                for (const f of files)
+                    existing.files.add(f);
+            }
+            else {
+                groups.push({ dir, files: new Set(files) });
+            }
+        }
+    }
+    // Paso 2: refinamiento por densidad de edges
+    let changed = true;
+    while (changed) {
+        changed = false;
+        outer: for (let i = 0; i < groups.length; i++) {
+            for (let j = i + 1; j < groups.length; j++) {
+                const a = groups[i];
+                const b = groups[j];
+                const merged = new Set([...a.files, ...b.files]);
+                let internalEdges = 0;
+                let externalEdges = 0;
+                for (const edge of graph.edges) {
+                    const fromIn = merged.has(edge.from);
+                    const toIn = merged.has(edge.to);
+                    if (fromIn && toIn)
+                        internalEdges++;
+                    else if (fromIn || toIn)
+                        externalEdges++;
+                }
+                const total = internalEdges + externalEdges;
+                if (total > 0 && internalEdges / total > DENSITY_THRESHOLD) {
+                    for (const f of b.files)
+                        a.files.add(f);
+                    groups.splice(j, 1);
+                    changed = true;
+                    break outer;
+                }
+            }
+        }
+    }
+    const result = new Map();
+    groups.forEach(({ dir, files }, i) => {
+        const id = `community-${i}`;
+        const label = dir === '(root)' ? 'root' : path.basename(dir);
+        const fileList = [...files];
+        result.set(id, { id, label, files: fileList, size: fileList.length });
+    });
+    return result;
+}
+//# sourceMappingURL=communities.js.map

package/dist/analyzer/communities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"communities.js","sourceRoot":"","sources":["../../src/analyzer/communities.ts"],"names":[],"mappings":"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"}

package/dist/analyzer/graph.d.ts

@@ -0,0 +1,36 @@
+export interface FileNode {
+    id: string;
+    path: string;
+    language: string;
+    imports: string[];
+    importedBy: string[];
+    externalDeps: string[];
+}
+export interface DependencyGraph {
+    nodes: Map<string, FileNode>;
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+}
+export interface GraphMetrics {
+    fileCount: number;
+    edgeCount: number;
+    hotspots: Array<{
+        file: string;
+        fanIn: number;
+    }>;
+    deadCode: string[];
+    avgFanIn: number;
+    avgFanOut: number;
+}
+export interface EntryPoint {
+    file: string;
+    reason: string;
+    confidence: 'high' | 'medium' | 'low';
+}
+export declare function buildGraph(rootPath: string): Promise<DependencyGraph>;
+export declare function computeMetrics(graph: DependencyGraph, options?: {
+    hotspotThreshold?: number;
+}): GraphMetrics;
+export declare function detectEntryPoints(graph: DependencyGraph, rootPath: string): EntryPoint[];

package/dist/analyzer/graph.js

@@ -0,0 +1,174 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { parseImports, resolveRelativePath } from './parser.js';
+const IGNORED_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', '__pycache__',
+    'vendor', '.venv', 'venv', 'out', 'coverage', '.next', '.nuxt',
+]);
+const LANG_MAP = {
+    '.ts': 'typescript', '.tsx': 'typescript',
+    '.js': 'javascript', '.jsx': 'javascript',
+    '.py': 'python',
+    '.php': 'php',
+};
+const ENTRY_NAMES = new Set(['main', 'index', 'app', 'server', 'cli', 'entry', 'bootstrap']);
+const TEST_DIRS = ['tests/', 'test/', '__tests__/', 'spec/', 'specs/'];
+const TEST_SUFFIXES = ['.test.', '.spec.', '_test.', '_spec.'];
+function isDeadCodeCandidate(id) {
+    const normalized = id.replace(/\\/g, '/');
+    if (TEST_DIRS.some(d => normalized.includes(d)))
+        return false;
+    if (TEST_SUFFIXES.some(s => normalized.includes(s)))
+        return false;
+    const base = path.basename(normalized, path.extname(normalized)).toLowerCase();
+    if (ENTRY_NAMES.has(base))
+        return false;
+    return true;
+}
+const ENTRY_PATH_PATTERNS = ['/pages/', '/routes/', '/controllers/', '/app/'];
+const TRY_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.py', '.php'];
+const TRY_INDEX_SUFFIXES = [
+    '/index.ts', '/index.js', '/index.tsx', '/index.jsx', '/__init__.py',
+];
+async function collectFiles(rootPath) {
+    const results = [];
+    async function walk(dir) {
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const full = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    if (!IGNORED_DIRS.has(entry.name))
+                        await walk(full);
+                }
+                else if (entry.isFile() && LANG_MAP[path.extname(entry.name)]) {
+                    results.push(full);
+                }
+            }
+        }
+        catch {
+            // skip unreadable directories
+        }
+    }
+    await walk(rootPath);
+    return results;
+}
+function resolveToNode(rawId, nodes) {
+    if (nodes.has(rawId))
+        return nodes.get(rawId);
+    // Try appending extensions directly
+    for (const ext of TRY_EXTENSIONS) {
+        const candidate = rawId + ext;
+        if (nodes.has(candidate))
+            return nodes.get(candidate);
+    }
+    // Strip existing extension and try other extensions (handles .js -> .ts substitution)
+    const strippedExt = path.extname(rawId);
+    if (strippedExt) {
+        const withoutExt = rawId.slice(0, rawId.length - strippedExt.length);
+        if (nodes.has(withoutExt))
+            return nodes.get(withoutExt);
+        for (const ext of TRY_EXTENSIONS) {
+            const candidate = withoutExt + ext;
+            if (nodes.has(candidate))
+                return nodes.get(candidate);
+        }
+        for (const suffix of TRY_INDEX_SUFFIXES) {
+            const candidate = withoutExt + suffix;
+            if (nodes.has(candidate))
+                return nodes.get(candidate);
+        }
+    }
+    for (const suffix of TRY_INDEX_SUFFIXES) {
+        const candidate = rawId + suffix;
+        if (nodes.has(candidate))
+            return nodes.get(candidate);
+    }
+    return undefined;
+}
+export async function buildGraph(rootPath) {
+    const absRoot = path.resolve(rootPath);
+    const files = await collectFiles(absRoot);
+    const nodes = new Map();
+    for (const filePath of files) {
+        const id = path.relative(absRoot, filePath);
+        nodes.set(id, {
+            id,
+            path: filePath,
+            language: LANG_MAP[path.extname(filePath)],
+            imports: [],
+            importedBy: [],
+            externalDeps: [],
+        });
+    }
+    const edges = [];
+    for (const [id, node] of nodes) {
+        let content;
+        try {
+            content = await fs.readFile(node.path, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const { relative, external } = parseImports(content, node.language);
+        node.externalDeps = external;
+        for (const rel of relative) {
+            const resolved = resolveRelativePath(rel, node.path);
+            if (!resolved)
+                continue;
+            const rawId = path.relative(absRoot, resolved);
+            const target = resolveToNode(rawId, nodes);
+            if (target) {
+                node.imports.push(target.id);
+                target.importedBy.push(id);
+                edges.push({ from: id, to: target.id });
+            }
+        }
+    }
+    return { nodes, edges };
+}
+export function computeMetrics(graph, options = {}) {
+    const threshold = options.hotspotThreshold ?? 5;
+    const nodeList = [...graph.nodes.values()];
+    const fileCount = nodeList.length;
+    const edgeCount = graph.edges.length;
+    const hotspots = nodeList
+        .filter(n => n.importedBy.length > threshold)
+        .map(n => ({ file: n.id, fanIn: n.importedBy.length }))
+        .sort((a, b) => b.fanIn - a.fanIn);
+    const deadCode = nodeList
+        .filter(n => n.importedBy.length === 0 && isDeadCodeCandidate(n.id))
+        .map(n => n.id);
+    const avgFanIn = fileCount > 0
+        ? nodeList.reduce((s, n) => s + n.importedBy.length, 0) / fileCount : 0;
+    const avgFanOut = fileCount > 0
+        ? nodeList.reduce((s, n) => s + n.imports.length, 0) / fileCount : 0;
+    return { fileCount, edgeCount, hotspots, deadCode, avgFanIn, avgFanOut };
+}
+export function detectEntryPoints(graph, rootPath) {
+    const entries = [];
+    const seen = new Set();
+    for (const node of graph.nodes.values()) {
+        const base = path.basename(node.id, path.extname(node.id)).toLowerCase();
+        if (ENTRY_NAMES.has(base)) {
+            entries.push({ file: node.id, reason: `filename: ${base}`, confidence: 'high' });
+            seen.add(node.id);
+        }
+    }
+    for (const node of graph.nodes.values()) {
+        if (seen.has(node.id))
+            continue;
+        if (ENTRY_PATH_PATTERNS.some(p => node.path.includes(p))) {
+            entries.push({ file: node.id, reason: 'path matches routing pattern', confidence: 'medium' });
+            seen.add(node.id);
+        }
+    }
+    for (const node of graph.nodes.values()) {
+        if (!seen.has(node.id) && node.importedBy.length === 0) {
+            entries.push({ file: node.id, reason: 'fanIn=0, no other file imports it', confidence: 'low' });
+            seen.add(node.id);
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=graph.js.map

package/dist/analyzer/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/analyzer/graph.ts"],"names":[],"mappings":"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"}

package/dist/analyzer/parser.d.ts

@@ -0,0 +1,6 @@
+export interface ParsedImports {
+    relative: string[];
+    external: string[];
+}
+export declare function parseImports(content: string, language: string): ParsedImports;
+export declare function resolveRelativePath(importPath: string, fromFile: string): string | null;

package/dist/analyzer/parser.js

@@ -0,0 +1,60 @@
+import path from 'path';
+const JS_TS_IMPORT = /(?:^|[\n;])\s*import\s+(?:type\s+)?(?:[\w*{},\s]+\s+from\s+)?['"]([^'"]+)['"]/gm;
+const JS_TS_REEXPORT = /(?:^|[\n;])\s*export\s+\{[^}]*\}\s+from\s+['"]([^'"]+)['"]/gm;
+const JS_REQUIRE = /(?:^|[\n;])\s*(?:const|let|var)\s+\w+\s*=\s*require\s*\(\s*['"]([^'"]+)['"]\s*\)/gm;
+const PY_FROM_RELATIVE = /^[ \t]*from\s+(\.+\w*)\s+import/gm;
+const PY_FROM_ABSOLUTE = /^[ \t]*from\s+(\w[\w.]*)\s+import/gm;
+const PY_IMPORT = /^[ \t]*import\s+([\w.]+)/gm;
+const PHP_REQUIRE = /(?:require|require_once|include|include_once)\s*['"(]\s*([^'")\s]+)/gm;
+const PHP_USE = /^[ \t]*use\s+([\w\\]+)/gm;
+function extractMatches(pattern, content) {
+    pattern.lastIndex = 0;
+    const results = [];
+    let m;
+    while ((m = pattern.exec(content)) !== null) {
+        if (m[1])
+            results.push(m[1]);
+    }
+    return results;
+}
+export function parseImports(content, language) {
+    const relative = [];
+    const external = [];
+    if (language === 'typescript' || language === 'javascript') {
+        const all = [
+            ...extractMatches(JS_TS_IMPORT, content),
+            ...extractMatches(JS_TS_REEXPORT, content),
+            ...extractMatches(JS_REQUIRE, content),
+        ];
+        for (const imp of all) {
+            if (imp.startsWith('.')) {
+                relative.push(imp);
+            }
+            else {
+                const pkg = imp.startsWith('@')
+                    ? imp.split('/').slice(0, 2).join('/')
+                    : imp.split('/')[0];
+                if (pkg)
+                    external.push(pkg);
+            }
+        }
+    }
+    else if (language === 'python') {
+        relative.push(...extractMatches(PY_FROM_RELATIVE, content));
+        external.push(...extractMatches(PY_FROM_ABSOLUTE, content), ...extractMatches(PY_IMPORT, content));
+    }
+    else if (language === 'php') {
+        relative.push(...extractMatches(PHP_REQUIRE, content));
+        external.push(...extractMatches(PHP_USE, content));
+    }
+    return {
+        relative: [...new Set(relative)],
+        external: [...new Set(external)],
+    };
+}
+export function resolveRelativePath(importPath, fromFile) {
+    if (!importPath.startsWith('.'))
+        return null;
+    return path.resolve(path.dirname(fromFile), importPath);
+}
+//# sourceMappingURL=parser.js.map

package/dist/analyzer/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/analyzer/parser.ts"],"names":[],"mappings":"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"}

package/dist/analyzer/stack.d.ts

@@ -0,0 +1,8 @@
+export interface StackInfo {
+    languages: string[];
+    frameworks: string[];
+    projectType: 'frontend' | 'backend' | 'fullstack' | 'agent' | 'library';
+    packageManager: string;
+    runtimes: string[];
+}
+export declare function detectStack(rootPath: string): Promise<StackInfo>;

package/dist/analyzer/stack.js

@@ -0,0 +1,115 @@
+import fs from 'fs/promises';
+import path from 'path';
+const FRONTEND = new Set(['react', 'vue', 'svelte', '@angular/core', 'astro', 'next', 'nuxt', 'preact', 'solid-js']);
+const BACKEND = new Set(['express', 'fastify', 'koa', 'hapi', '@nestjs/core', 'nestjs', 'django', 'flask', 'fastapi', 'aiohttp', 'tornado']);
+const AGENT = new Set(['anthropic', '@anthropic-ai/sdk', 'openai', 'langchain', '@langchain/core', 'llamaindex', 'groq']);
+const IGNORED = new Set(['node_modules', '.git', 'dist', 'build', '__pycache__', 'vendor']);
+async function tryReadJson(p) {
+    try {
+        return JSON.parse(await fs.readFile(p, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+async function tryReadText(p) {
+    try {
+        return await fs.readFile(p, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+async function exists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function countExts(rootPath) {
+    const counts = new Map();
+    async function walk(dir) {
+        try {
+            for (const e of await fs.readdir(dir, { withFileTypes: true })) {
+                if (e.isDirectory() && !IGNORED.has(e.name))
+                    await walk(path.join(dir, e.name));
+                else if (e.isFile()) {
+                    const ext = path.extname(e.name);
+                    counts.set(ext, (counts.get(ext) ?? 0) + 1);
+                }
+            }
+        }
+        catch { /* skip */ }
+    }
+    await walk(rootPath);
+    return counts;
+}
+export async function detectStack(rootPath) {
+    const abs = path.resolve(rootPath);
+    const allDeps = [];
+    const runtimes = [];
+    let packageManager = 'unknown';
+    const pkg = await tryReadJson(path.join(abs, 'package.json'));
+    if (pkg) {
+        const d = pkg.dependencies;
+        const dd = pkg.devDependencies;
+        allDeps.push(...Object.keys(d ?? {}), ...Object.keys(dd ?? {}));
+    }
+    const req = await tryReadText(path.join(abs, 'requirements.txt'));
+    if (req) {
+        allDeps.push(...req.split('\n').map(l => l.split(/[>=<!]/)[0].trim().toLowerCase()).filter(Boolean));
+    }
+    if (await exists(path.join(abs, 'Cargo.toml')))
+        runtimes.push('rust');
+    if (await exists(path.join(abs, 'go.mod')))
+        runtimes.push('go');
+    if (await exists(path.join(abs, 'composer.json')))
+        runtimes.push('php');
+    if (await exists(path.join(abs, 'pnpm-lock.yaml')))
+        packageManager = 'pnpm';
+    else if (await exists(path.join(abs, 'bun.lock')))
+        packageManager = 'bun';
+    else if (await exists(path.join(abs, 'yarn.lock')))
+        packageManager = 'yarn';
+    else if (await exists(path.join(abs, 'package-lock.json')))
+        packageManager = 'npm';
+    else if (pkg)
+        packageManager = 'npm';
+    const extCounts = await countExts(abs);
+    const languages = [];
+    if ((extCounts.get('.ts') ?? 0) + (extCounts.get('.tsx') ?? 0) > 0)
+        languages.push('typescript');
+    if ((extCounts.get('.js') ?? 0) + (extCounts.get('.jsx') ?? 0) > 0)
+        languages.push('javascript');
+    if ((extCounts.get('.py') ?? 0) > 0)
+        languages.push('python');
+    if ((extCounts.get('.php') ?? 0) > 0)
+        languages.push('php');
+    if ((extCounts.get('.rs') ?? 0) > 0)
+        languages.push('rust');
+    if ((extCounts.get('.go') ?? 0) > 0)
+        languages.push('go');
+    const depsLow = allDeps.map(d => d.toLowerCase());
+    const frameworks = [...new Set([
+            ...depsLow.filter(d => FRONTEND.has(d)),
+            ...depsLow.filter(d => BACKEND.has(d)),
+            ...depsLow.filter(d => AGENT.has(d)),
+        ])];
+    const isFrontend = depsLow.some(d => FRONTEND.has(d));
+    const isBackend = depsLow.some(d => BACKEND.has(d));
+    const isAgent = depsLow.some(d => AGENT.has(d));
+    let projectType = 'library';
+    if (isAgent)
+        projectType = 'agent';
+    else if (isFrontend && isBackend)
+        projectType = 'fullstack';
+    else if (isFrontend)
+        projectType = 'frontend';
+    else if (isBackend)
+        projectType = 'backend';
+    return { languages, frameworks, projectType, packageManager, runtimes };
+}
+//# sourceMappingURL=stack.js.map

package/dist/analyzer/stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.js","sourceRoot":"","sources":["../../src/analyzer/stack.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,11 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerTools } from './tools/index.js';
+const server = new McpServer({
+    name: 'graphmycode',
+    version: '0.1.0',
+});
+registerTools(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAA;AAEF,aAAa,CAAC,MAAM,CAAC,CAAA;AAErB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;AAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA"}

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerTools(server: McpServer): void;

package/dist/tools/index.js

@@ -0,0 +1,169 @@
+import { z } from 'zod';
+import { buildGraph, computeMetrics, detectEntryPoints } from '../analyzer/graph.js';
+import { detectStack } from '../analyzer/stack.js';
+import { buildCommunities } from '../analyzer/communities.js';
+import { generateAgentContext } from '../analyzer/agent.js';
+function detectCycles(graph) {
+    const cycles = [];
+    const visited = new Set();
+    const stack = new Set();
+    const currentPath = [];
+    function dfs(id) {
+        if (stack.has(id)) {
+            const start = currentPath.indexOf(id);
+            cycles.push(currentPath.slice(start));
+            return;
+        }
+        if (visited.has(id))
+            return;
+        visited.add(id);
+        stack.add(id);
+        currentPath.push(id);
+        for (const imp of (graph.nodes.get(id)?.imports ?? []))
+            dfs(imp);
+        stack.delete(id);
+        currentPath.pop();
+    }
+    for (const id of graph.nodes.keys()) {
+        if (!visited.has(id))
+            dfs(id);
+    }
+    return cycles;
+}
+export function registerTools(server) {
+    server.tool('analyze_structure', { path: z.string().describe('Absolute path to the codebase root') }, async ({ path }) => {
+        const graph = await buildGraph(path);
+        const metrics = computeMetrics(graph);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        nodes: [...graph.nodes.values()].map(n => ({
+                            id: n.id, language: n.language,
+                            fanIn: n.importedBy.length, fanOut: n.imports.length,
+                            externalDeps: n.externalDeps,
+                        })),
+                        edges: graph.edges,
+                        metrics: {
+                            fileCount: metrics.fileCount,
+                            edgeCount: metrics.edgeCount,
+                            hotspots: metrics.hotspots,
+                            deadCode: metrics.deadCode,
+                            avgFanIn: Math.round(metrics.avgFanIn * 100) / 100,
+                            avgFanOut: Math.round(metrics.avgFanOut * 100) / 100,
+                        },
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('detect_stack', { path: z.string().describe('Absolute path to the codebase root') }, async ({ path }) => {
+        const stack = await detectStack(path);
+        return { content: [{ type: 'text', text: JSON.stringify(stack, null, 2) }] };
+    });
+    server.tool('get_file_dependencies', {
+        path: z.string().describe('Absolute path to the codebase root'),
+        file: z.string().describe('Relative file path within the codebase (e.g. src/utils.ts)'),
+    }, async ({ path, file }) => {
+        const graph = await buildGraph(path);
+        const node = graph.nodes.get(file);
+        if (!node) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: `File not found: ${file}`, available: [...graph.nodes.keys()] }),
+                    }],
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        file: node.id,
+                        imports: node.imports,
+                        importedBy: node.importedBy,
+                        externalDeps: node.externalDeps,
+                    }, null, 2),
+                }],
+        };
+    });
+    server.tool('get_communities', { path: z.string().describe('Absolute path to the codebase root') }, async ({ path }) => {
+        const graph = await buildGraph(path);
+        const communities = buildCommunities(graph);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ communities: [...communities.values()] }, null, 2),
+                }],
+        };
+    });
+    server.tool('find_entry_points', { path: z.string().describe('Absolute path to the codebase root') }, async ({ path }) => {
+        const graph = await buildGraph(path);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ entryPoints: detectEntryPoints(graph, path) }, null, 2),
+                }],
+        };
+    });
+    server.tool('query_graph', {
+        path: z.string().describe('Absolute path to the codebase root'),
+        question: z.string().describe('Natural language question about the codebase'),
+    }, async ({ path, question }) => {
+        const graph = await buildGraph(path);
+        const q = question.toLowerCase();
+        let answer = '';
+        const evidence = [];
+        const importerMatch = q.match(/(?:qui[eé]n importa|who imports?|importa)\s+['"]?([^\s'"?]+)['"]?/);
+        if (importerMatch) {
+            const target = importerMatch[1];
+            const found = [...graph.nodes.entries()].find(([id]) => id.includes(target));
+            if (found) {
+                const [id, node] = found;
+                answer = `${node.importedBy.length} file(s) import \`${id}\`: ${node.importedBy.join(', ') || 'none'}`;
+                evidence.push({ file: id, metric: 'fanIn', value: node.importedBy.length });
+            }
+            else {
+                answer = `No file matching "${target}" found.`;
+            }
+        }
+        else if (q.includes('ciclo') || q.includes('cycle') || q.includes('circular')) {
+            const cycles = detectCycles(graph);
+            answer = cycles.length === 0
+                ? 'No circular import cycles detected.'
+                : `Found ${cycles.length} cycle(s):\n${cycles.map(c => c.join(' → ')).join('\n')}`;
+            cycles.forEach(c => evidence.push({ file: c[0], metric: 'cycle', value: c }));
+        }
+        else if (q.includes('muerto') || q.includes('dead') || q.includes('unused')) {
+            const m = computeMetrics(graph);
+            answer = m.deadCode.length > 0
+                ? `${m.deadCode.length} possibly unused file(s): ${m.deadCode.slice(0, 10).join(', ')}`
+                : 'No dead code detected.';
+            m.deadCode.forEach(f => evidence.push({ file: f, metric: 'fanIn', value: 0 }));
+        }
+        else if (q.includes('central') || q.includes('importado') || q.includes('fanin')) {
+            const sorted = [...graph.nodes.values()].sort((a, b) => b.importedBy.length - a.importedBy.length).slice(0, 5);
+            answer = 'Most central files:\n' + sorted.map(n => `${n.id}: fanIn=${n.importedBy.length}`).join('\n');
+            sorted.forEach(n => evidence.push({ file: n.id, metric: 'fanIn', value: n.importedBy.length }));
+        }
+        else if (q.includes('dependencia') || q.includes('dependencies') || q.includes('fanout')) {
+            const sorted = [...graph.nodes.values()].sort((a, b) => b.imports.length - a.imports.length).slice(0, 5);
+            answer = 'Files with most dependencies:\n' + sorted.map(n => `${n.id}: fanOut=${n.imports.length}`).join('\n');
+            sorted.forEach(n => evidence.push({ file: n.id, metric: 'fanOut', value: n.imports.length }));
+        }
+        else {
+            const m = computeMetrics(graph);
+            answer = `Graph: ${m.fileCount} files, ${m.edgeCount} edges, avgFanIn=${m.avgFanIn.toFixed(2)}, avgFanOut=${m.avgFanOut.toFixed(2)}`;
+        }
+        return { content: [{ type: 'text', text: JSON.stringify({ answer, evidence }, null, 2) }] };
+    });
+    server.tool('export_agent_context', {
+        path: z.string().describe('Absolute path to the codebase root'),
+        format: z.enum(['CLAUDE.md', 'AGENTS.md', 'both']).describe('Output format'),
+    }, async ({ path, format }) => {
+        const [graph, stack] = await Promise.all([buildGraph(path), detectStack(path)]);
+        const communities = buildCommunities(graph);
+        const files = await generateAgentContext(path, graph, stack, communities, format);
+        return { content: [{ type: 'text', text: JSON.stringify({ files }, null, 2) }] };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "graphmycode-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for codebase structure analysis — dependency graphs, communities, hotspots, and agent context generation",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "graphmycode-mcp": "scripts/cli.mjs"
+  },
+  "files": [
+    "dist",
+    "commands",
+    "scripts"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run --reporter=verbose",
+    "prepublishOnly": "npm run build",
+    "postinstall": "node scripts/postinstall.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "codebase",
+    "dependency-graph",
+    "code-analysis",
+    "claude-code"
+  ],
+  "author": "Francisco Valero",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.1.0"
+  }
+}

package/scripts/cli.mjs

@@ -0,0 +1,8 @@
+#!/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();
+} else {
+  await import('../dist/index.js');
+}

package/scripts/postinstall.mjs

@@ -0,0 +1,14 @@
+import { setup } from './setup.mjs';
+
+// Solo ejecutar en instalación global para no tocar ~/.claude en entornos de desarrollo
+if (process.env.npm_config_global !== 'true') {
+  process.exit(0);
+}
+
+try {
+  setup();
+} catch (e) {
+  // Nunca fallar la instalación de npm
+  console.warn('\nGraphMyCode: el setup automático falló:', e.message);
+  console.warn('Ejecuta el setup manualmente con: graphmycode-mcp setup\n');
+}

package/scripts/setup.mjs

@@ -0,0 +1,62 @@
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import path from 'path';
+import fs from 'fs';
+import os from 'os';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.dirname(__dirname);
+const distPath = path.join(packageRoot, 'dist', 'index.js');
+const nodePath = process.execPath;
+const commandsSource = path.join(packageRoot, 'commands');
+const commandsDest = path.join(os.homedir(), '.claude', 'commands');
+
+function registerMcp() {
+  try {
+    execSync(`claude mcp add -s user graphmycode -- "${nodePath}" "${distPath}"`, {
+      stdio: 'pipe',
+    });
+    console.log('✓ MCP graphmycode registrado en Claude Code');
+  } 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');
+      }
+    } else {
+      console.warn('⚠  No se pudo registrar el MCP automáticamente.');
+      console.warn('   Ejecuta manualmente:');
+      console.warn(`   claude mcp add -s user graphmycode -- "${nodePath}" "${distPath}"`);
+    }
+  }
+}
+
+function copyCommands() {
+  if (!fs.existsSync(commandsSource)) return;
+
+  fs.mkdirSync(commandsDest, { recursive: true });
+
+  const files = fs.readdirSync(commandsSource).filter((f) => f.endsWith('.md'));
+  for (const file of files) {
+    fs.copyFileSync(path.join(commandsSource, file), path.join(commandsDest, file));
+  }
+  console.log(`✓ ${files.length} slash commands instalados en ~/.claude/commands/`);
+  console.log('  ' + files.map((f) => `/${f.replace('.md', '')}`).join(', '));
+}
+
+export function setup() {
+  if (!fs.existsSync(distPath)) {
+    console.error('Error: dist/index.js no encontrado. El paquete puede estar corrupto.');
+    process.exit(1);
+  }
+
+  console.log('\nConfigurando GraphMyCode MCP...\n');
+  registerMcp();
+  copyCommands();
+  console.log('\n¡Listo! Reinicia Claude Code para activar los cambios.\n');
+}