# project-graph-mcp

An MCP server that enables AI agents to read, navigate, and edit codebases through compact structural context and focused source detail.

## Key Features
- **Project Skeletons**: Compact AST-based maps of files, symbols, and relationships.
- **Two-Tier Context**: High-level structural skeleton + detailed focus zone.
- **Bi-directional Pipeline**: Automatic compacting for AI reading and expanding back for human-readable editing.
- **Code Quality Analysis**: Health summary, cyclomatic complexity, dead code detection, duplicates, and large files.
- **Custom Rules**: Linting based on project dependencies.

## Key Links
- Home: https://rnd-pro.github.io/project-graph-mcp/
- Docs: https://rnd-pro.github.io/project-graph-mcp/docs/
- Tools Catalog: https://rnd-pro.github.io/project-graph-mcp/docs/tools/
- Architecture: https://rnd-pro.github.io/project-graph-mcp/docs/architecture/
- Getting Started: https://rnd-pro.github.io/project-graph-mcp/docs/getting-started/

## CLI Usage Examples
- `npx project-graph-mcp skeleton src/`
- `npx project-graph-mcp expand SymbolName`
- `npx project-graph-mcp analyze src/`
- `npx project-graph-mcp docs src/`
- `npx project-graph-mcp validate-ctx .`