io.github.HandyS11/projgraph MCP Server

This MCP server analyzes .NET solutions to generate visual artifacts and metrics. It supports creation of Mermaid graphs, ERDs, class diagrams, and provides project-level dependency and analysis outputs.

🛠️ Key Features

Analyze .NET solutions
Generate Mermaid graphs
Generate ERDs
Generate class diagrams
Produce project metrics

🚀 Use Cases

Visualize project dependencies in .NET
Document database schemas via ERDs
Review class hierarchies using class diagrams
Summarize project metrics for dependency and structure assessment

⚡ Developer Benefits

Consumes .NET solution structure for visualization
Produces developer-readable diagrams (Mermaid graphs, ERDs, class diagrams)
Helps with dependency, schema, and hierarchy understanding using project metrics

⚠️ Limitations

Scope is described as .NET solution analysis only; no other languages or inputs are stated.

ProjGraph

.NET tool ecosystem for visualizing project dependencies, database schemas, and class hierarchies.

ProjGraph is a .NET tool ecosystem for visualizing project dependencies, database schemas, and class hierarchies. It provides both a CLI for manual analysis and an MCP server for AI-assisted exploration of your codebase architecture.

🚀 Quick Start

CLI Tool

Install and use the command-line tool for immediate visualization:

bash

# Install
dotnet tool install -g ProjGraph.Cli

# Visualize project dependencies
projgraph visualize ./MySolution.slnx

# Generate Entity Relationship Diagram (from DbContext or ModelSnapshot)
projgraph erd ./Data/MyDbContext.cs

# Generate Class Diagram for a class and its hierarchy
projgraph classdiagram ./Models/User.cs

# Compute key solution metrics (project counts, depth, hotspots)
projgraph stats ./MySolution.slnx

📖 Full CLI Documentation

MCP Server

Configure your MCP client (e.g., GitHub Copilot, Claude) with the following settings:

Find the latest version number on NuGet

json

{
  "servers": {
    "ProjGraph.Mcp": {
      "type": "stdio",
      "command": "dnx",
      "args": ["ProjGraph.Mcp@x.x.x", "--yes"]
    }
  }
}

📖 Full MCP Documentation

✨ Key Features

📊 Multiple Output Formats: ASCII tree and Mermaid.js diagrams
🗄️ Entity Relationship Diagrams: Generate ERDs from EF Core DbContext or ModelSnapshot files
🏗️ Class Hierarchies: Visualize class diagrams with inheritance and dependencies
📈 Solution Metrics: Project counts, type breakdown, dependency depth, and hotspot detection
📁 Modern .NET Support: Full support for .slnx, .sln, and .csproj files
🤖 AI Integration: MCP server for GitHub Copilot, Claude, and other AI assistants
⚡ Fast & Reliable: Efficient parsing and graph algorithms

🛠️ Development

Prerequisites

.NET 10.0 SDK or later

Run Locally

bash

# CLI
dotnet run --project src/ProjGraph.Cli -- visualize ./ProjGraph.slnx

# Stats
dotnet run --project src/ProjGraph.Cli -- stats ./ProjGraph.slnx

# MCP Server
dotnet run --project src/ProjGraph.Mcp

📝 Usage Examples

Analyze Project Dependencies

bash

# Mermaid format (default)
projgraph visualize ./MySolution.sln

# ASCII tree format
projgraph visualize ./MySolution.sln --format tree

# Mermaid format for documentation
projgraph visualize ./MySolution.slnx --format mermaid --output docs/dependencies.mmd

Generate Database Diagrams

bash

# Generate ERD from DbContext
projgraph erd ./Data/MyDbContext.cs

# Generate ERD from ModelSnapshot (leveraging migrations)
projgraph erd ./Migrations/MyDbContextModelSnapshot.cs

# Output to Markdown for documentation
projgraph erd ./Data/MyDbContext.cs --output docs/database-schema.md

# Control how EF Core owned types (OwnsOne/OwnsMany) are rendered:
# 'mirror' (default) inlines a table-split owned type onto its owner as EF names it;
# 'classic' gives every owned type its own entity box regardless of table mapping
projgraph erd ./Data/MyDbContext.cs --owned-mode classic

Visualize Class Hierarchies

bash

# Generate diagram for a class and its inheritance and dependencies
projgraph classdiagram ./Models/Admin.cs -i -d

# Control discovery depth (default: 1)
projgraph classdiagram ./Models/Admin.cs -i -d --depth 5

Analyze Solution Metrics

bash

# Display project counts, depth stats, and hotspot projects
projgraph stats ./MySolution.slnx

# Show top 10 most-referenced projects
projgraph stats ./MySolution.slnx --top 10

With AI Assistants

Once the MCP server is configured:

text

You: "Analyze the dependencies in my solution"
AI: [Generate the architecture diagram]

You: "Generate a class diagram for the User class"
AI: [Generates the class hierarchy]

You: "Show me the entity relationships in my DbContext"
AI: [Generates the database schema]

You: "Give me a health summary of my solution"
AI: [Returns project counts, depth stats, and hotspot projects]

🔗 Links

CLI Package: ProjGraph.Cli on NuGet
MCP Package: ProjGraph.Mcp on NuGet

📚 Samples & Showcase

Explore live examples of ProjGraph's capabilities in the Samples Showcase. Available samples include:

E-commerce ERD: Complex database model with inheritance and hierarchies.
Design Patterns: Deep class diagrams showing pattern implementation.
Modular Architecture: Project dependency visualization for modern solutions.
Simple Hierarchy: Easy entry-level examples for new users.
Solution Metrics: Architectural health summary with project counts, depth, and hotspots.

📚 Documentation

Architecture Overview - Solution structure and design decisions
Contributing Guide - How to contribute to the project
Security Policy - Security reporting guidelines

ProjGraph MCP Server

io.github.HandyS11/projgraph MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

ProjGraph

🚀 Quick Start

CLI Tool

MCP Server

✨ Key Features

🛠️ Development

Prerequisites

Run Locally

📝 Usage Examples

Analyze Project Dependencies

Generate Database Diagrams

Visualize Class Hierarchies

Analyze Solution Metrics

With AI Assistants

🔗 Links

📚 Samples & Showcase

📚 Documentation

Install

Related servers