{
  "markdown": "<div align=\"center\">\n\n# ProjGraph\n\n**.NET tool ecosystem for visualizing project dependencies, database schemas, and class hierarchies.**\n\n[![CI](https://github.com/HandyS11/ProjGraph/actions/workflows/ci.yml/badge.svg)](https://github.com/HandyS11/ProjGraph/actions/workflows/ci.yml)\n[![CD](https://github.com/HandyS11/ProjGraph/actions/workflows/publish.yml/badge.svg)](https://github.com/HandyS11/ProjGraph/actions/workflows/publish.yml)\n[![License](https://img.shields.io/github/license/HandyS11/ProjGraph)](./LICENSE)\n\n[![ProjGraph.Cli NuGet](https://img.shields.io/nuget/v/ProjGraph.Cli?label=CLI&logo=nuget)](https://www.nuget.org/packages/ProjGraph.Cli)\n[![ProjGraph.Cli Downloads](https://img.shields.io/nuget/dt/ProjGraph.Cli?label=CLI%20downloads&logo=nuget)](https://www.nuget.org/packages/ProjGraph.Cli)\n[![ProjGraph.Mcp NuGet](https://img.shields.io/nuget/v/ProjGraph.Mcp?label=MCP&logo=nuget)](https://www.nuget.org/packages/ProjGraph.Mcp)\n[![ProjGraph.Mcp Downloads](https://img.shields.io/nuget/dt/ProjGraph.Mcp?label=MCP%20downloads&logo=nuget)](https://www.nuget.org/packages/ProjGraph.Mcp)\n\n</div>\n\n**ProjGraph** is a .NET tool ecosystem for visualizing project dependencies, database schemas, and class hierarchies.\nIt provides both a CLI for manual analysis and an MCP server for AI-assisted exploration of your codebase architecture.\n\n## 🚀 Quick Start\n\n### CLI Tool\n\nInstall and use the command-line tool for immediate visualization:\n\n```bash\n# Install\ndotnet tool install -g ProjGraph.Cli\n\n# Visualize project dependencies\nprojgraph visualize ./MySolution.slnx\n\n# Generate Entity Relationship Diagram (from DbContext or ModelSnapshot)\nprojgraph erd ./Data/MyDbContext.cs\n\n# Generate Class Diagram for a class and its hierarchy\nprojgraph classdiagram ./Models/User.cs\n\n# Compute key solution metrics (project counts, depth, hotspots)\nprojgraph stats ./MySolution.slnx\n```\n\n📖 [Full CLI Documentation](./src/ProjGraph.Cli/README.md)\n\n### MCP Server\n\nConfigure your MCP client (e.g., GitHub Copilot, Claude) with the following settings:\n\n> Find the latest version number on [NuGet](https://www.nuget.org/packages/ProjGraph.Mcp)\n\n```json\n{\n  \"servers\": {\n    \"ProjGraph.Mcp\": {\n      \"type\": \"stdio\",\n      \"command\": \"dnx\",\n      \"args\": [\"ProjGraph.Mcp@x.x.x\", \"--yes\"]\n    }\n  }\n}\n```\n\n📖 [Full MCP Documentation](./src/ProjGraph.Mcp/README.md)\n\n## ✨ Key Features\n\n- **📊 Multiple Output Formats**: ASCII tree and Mermaid.js diagrams\n- **🗄️ Entity Relationship Diagrams**: Generate ERDs from EF Core `DbContext` or `ModelSnapshot` files\n- **🏗️ Class Hierarchies**: Visualize class diagrams with inheritance and dependencies\n- **📈 Solution Metrics**: Project counts, type breakdown, dependency depth, and hotspot detection\n- **📁 Modern .NET Support**: Full support for `.slnx`, `.sln`, and `.csproj` files\n- **🤖 AI Integration**: MCP server for GitHub Copilot, Claude, and other AI assistants\n- **⚡ Fast & Reliable**: Efficient parsing and graph algorithms\n\n## 🛠️ Development\n\n### Prerequisites\n\n- [.NET 10.0 SDK](https://dotnet.microsoft.com/download) or later\n\n### Run Locally\n\n```bash\n# CLI\ndotnet run --project src/ProjGraph.Cli -- visualize ./ProjGraph.slnx\n\n# Stats\ndotnet run --project src/ProjGraph.Cli -- stats ./ProjGraph.slnx\n\n# MCP Server\ndotnet run --project src/ProjGraph.Mcp\n```\n\n## 📝 Usage Examples\n\n### Analyze Project Dependencies\n\n```bash\n# Tree format (default)\nprojgraph visualize ./MySolution.sln\n\n# Mermaid format for documentation\nprojgraph visualize ./MySolution.slnx --format mermaid --output docs/dependencies.mmd\n```\n\n### Generate Database Diagrams\n\n```bash\n# Generate ERD from DbContext\nprojgraph erd ./Data/MyDbContext.cs\n\n# Generate ERD from ModelSnapshot (leveraging migrations)\nprojgraph erd ./Migrations/MyDbContextModelSnapshot.cs\n\n# Output to Markdown for documentation\nprojgraph erd ./Data/MyDbContext.cs --output docs/database-schema.md\n\n# Control how EF Core owned types (OwnsOne/OwnsMany) are rendered:\n# 'mirror' (default) inlines a table-split owned type onto its owner as EF names it;\n# 'classic' gives every owned type its own entity box regardless of table mapping\nprojgraph erd ./Data/MyDbContext.cs --owned-mode classic\n```\n\n### Visualize Class Hierarchies\n\n```bash\n# Generate diagram for a class and its inheritance and dependencies\nprojgraph classdiagram ./Models/Admin.cs -i -d\n\n# Control discovery depth (default: 1)\nprojgraph classdiagram ./Models/Admin.cs -i -d --depth 5\n```\n\n### Analyze Solution Metrics\n\n```bash\n# Display project counts, depth stats, and hotspot projects\nprojgraph stats ./MySolution.slnx\n\n# Show top 10 most-referenced projects\nprojgraph stats ./MySolution.slnx --top 10\n```\n\n### With AI Assistants\n\nOnce the MCP server is configured:\n\n```text\nYou: \"Analyze the dependencies in my solution\"\nAI: [Generate the architecture diagram]\n\nYou: \"Generate a class diagram for the User class\"\nAI: [Generates the class hierarchy]\n\nYou: \"Show me the entity relationships in my DbContext\"\nAI: [Generates the database schema]\n\nYou: \"Give me a health summary of my solution\"\nAI: [Returns project counts, depth stats, and hotspot projects]\n```\n\n## 🔗 Links\n\n- **CLI Package**: [ProjGraph.Cli on NuGet](https://www.nuget.org/packages/ProjGraph.Cli)\n- **MCP Package**: [ProjGraph.Mcp on NuGet](https://www.nuget.org/packages/ProjGraph.Mcp)\n\n## 📚 Samples & Showcase\n\nExplore live examples of ProjGraph's capabilities in the [Samples Showcase](./samples/README.md).\nAvailable samples include:\n\n- **E-commerce ERD**: Complex database model with inheritance and hierarchies.\n- **Design Patterns**: Deep class diagrams showing pattern implementation.\n- **Modular Architecture**: Project dependency visualization for modern solutions.\n- **Simple Hierarchy**: Easy entry-level examples for new users.\n- **Solution Metrics**: Architectural health summary with project counts, depth, and hotspots.\n\n## 📚 Documentation\n\n- [Architecture Overview](./ARCHITECTURE.md) - Solution structure and design decisions\n- [Contributing Guide](./CONTRIBUTING.md) - How to contribute to the project\n- [Security Policy](./SECURITY.md) - Security reporting guidelines\n",
  "bytes": 6129,
  "sha": "6ab1528d16d0b820cc75f29f70b8491cbdff75f77890023604790fe6a03482d8",
  "repo_slug": "handys11/projgraph",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_handys11_projgraph_6886dde3/readme"
}