project-graph-mcp

Maximize your AI agent's context window. An MCP server that lets agents read and edit your codebase in compact mode — minified source with all variable names preserved. Code tokens drop ↓40%, and .ctx documentation is injected only in the focus zone. Fewer tokens per file → more files fit in context → deeper understanding of your codebase.

Features

• Project Skeleton — AST-based graph with 10-50x compression, minified JSON representation of your entire codebase

• Compact Code Mode — project-wide compact/beautify, agents read and edit minified source directly (↓40% tokens both ways)

• AI Context Layer — one call loads skeleton + docs + compressed files; progressive loading (Overview → Focus)

• Code Quality Analysis — dead code, complexity, duplicates, large files, legacy patterns, JSDoc consistency, Health Score (0-100)

• Multi-Language Parsers — JavaScript (AST/Acorn), TypeScript, Python, Go (regex-based)

• Doc Dialect — auto-generated .ctx documentation with AST signatures, staleness detection, self-enriching @enrich markers

• Database Analysis — schema extraction from SQL migrations, table usage, dead tables

• Test Checklists — persistent test state in .ctx.md files, agent-driven mark_test_passed

• Monorepo Support — auto-discovery of sub-projects in packages/, apps/, services/

• Framework Rules — 11 rulesets (86 rules) for React, Vue, Next.js, Express, NestJS, TypeScript, Node.js, Symbiote.js

• Security — path traversal protection on all operations

Related MCP server: Semantic Cache MCP

Quick Start

Generate the MCP config for your IDE (with correct paths):

npx -y project-graph-mcp config

Copy the output JSON into your IDE's MCP config file, then restart.

See CONFIGURATION.md for all supported IDEs.

git clone --recursive https://github.com/rnd-pro/project-graph-mcp
cd project-graph-mcp
npm install

Note: The source checkout no longer needs the former vendor/symbiote-node submodule.

CLI

npx project-graph-mcp skeleton src/       # Project skeleton
npx project-graph-mcp expand SN           # Expand minified symbol
npx project-graph-mcp deps SNG            # Get dependencies
npx project-graph-mcp deadcode src/       # Find unused code
npx project-graph-mcp complexity src/     # Cyclomatic complexity
npx project-graph-mcp analyze src/        # Full health analysis
npx project-graph-mcp compress src/f.js   # Compress file for AI
npx project-graph-mcp docs src/           # Project docs (doc-dialect)
npx project-graph-mcp generate-ctx src/   # Generate .context/ docs
npx project-graph-mcp compact src/ --dry-run  # Compact all files
npx project-graph-mcp mode .              # Show current editing mode
npx project-graph-mcp help                # All commands

Web Dashboard

MCP Ecosystem

Best used as part of mcp-agent-portal — a unified MCP aggregator that combines all RND-PRO servers behind a single config entry:

{
  "mcpServers": {
    "agent-portal": {
      "command": "npx",
      "args": ["-y", "mcp-agent-portal"]
    }
  }
}

Also works standalone when you need only project graph tools:

# Generate a config with the correct path for this server:
npx -y project-graph-mcp config
# Or use mcp-agent-portal as the unified orchestration gateway.

Documentation

• CONFIGURATION.md — Setup for all supported IDEs

• GUIDE.md — Comprehensive usage guide with all tools

• ARCHITECTURE.md — Source code structure

• AGENT_ROLE.md — Full system prompt for agents

• ROADMAP.md — Feature roadmap and backlog

Related Projects

• mcp-agent-portal — Unified MCP aggregator + web dashboard + AI agent runtime

• agent-pool-mcp — Internal execution runtime used by Agent Portal orchestration

• Symbiote.js — Isomorphic Reactive Web Components framework

• JSDA-Kit — SSG/SSR toolkit for modern web applications

License

MIT © RND-PRO.com

Made with ❤️ by the RND-PRO team