convez.ai
MCP ServerDesenvolvimento WebIntermediário
rnd-pro

Project Graph MCP

rnd-pro/project-graph-mcp

Comprime codebases inteiras em contexto de IA com análise integrada

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que comprime grafos de projetos inteiros em representações minificadas, reduzindo tokens em ~40% enquanto preserva nomes de variáveis e contexto. Oferece análise de código (dead code, complexidade, duplicatas), geração automática de documentação `.ctx`, checklists de testes e suporte a monorepos com 11 rulesets de linting.

Instalação

$npx convez-ai rnd-pro/project-graph-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Aumentar quantidade de arquivos no contexto de agentes IA via compressão eficiente
  • Análise de qualidade de código e detecção de dead code em projetos grandes
  • Geração e manutenção automática de documentação contextual com `.ctx` files
  • Integração com IDEs (Cursor, Windsurf, Claude Code) para leitura/edição de codebase

Veredito

Ferramenta especializada e bem-pensada para otimizar contexto de agentes IA em codebases grandes. Implementação madura com suporte a múltiplas linguagens, IDEs e rulesets robustos; excelente para times que precisam escalar análise de código com IA sem estourar token limits.

README

A tradução para o português deste README ainda está na fila.

npm version License: MIT Node.js

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.

Expanded view — formatted code with JSDoc, 28+ lines per function

Compact mode — same file, 14 lines total, ↓40% tokens. Agents read and edit this directly.

[!TIP] 18 MCP tools, zero config. Add one line to your MCP config and the server downloads itself on the next IDE restart.

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

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.

IDEConfig path
Antigravity~/.gemini/antigravity/mcp_config.json
Gemini CLI~/.gemini/settings.json
Cursor.cursor/mcp.json
Windsurf.windsurf/mcp.json
Claude CodeRun: claude mcp add project-graph npx -y project-graph-mcp

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

[!NOTE] project-graph-mcp is a pure stdio MCP server — it does not include a web server. For the visual UI (file tree, code viewer, dependency graph, live monitoring, marketplace), install mcp-agent-portal: npx mcp-agent-portal.

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"]
    }
  }
}

[!TIP] The Portal runs a singleton backend to prevent resource exhaustion when you open multiple IDE windows. It transparently spawns project-graph-mcp as a public child tool server and keeps agent-pool-mcp as its internal execution runtime. One mcp-agent-portal entry replaces separate public configs for child servers.

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.

[!IMPORTANT] Agent workers launched by Agent Portal can use their own project-graph-mcp instance to navigate the codebase independently without blocking the primary orchestrator.

Documentation

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

Ver o original no GitHub

Bom para

Relacionados