mcp-mermiad

# Submission for Awesome MCP Servers ## Repository https://github.com/punkpeye/awesome-mcp-servers ## Pull Request Details ### Category: Diagram Generation & Visualization ### Entry to Add: ```markdown #### Diagram Generation - **[Mermaid MCP Server](https://github.com/Narasimhaponnada/mermaid-mcp)** - AI-powered Mermaid diagram generation with 22+ diagram types including flowcharts, sequence diagrams, class diagrams, ER diagrams, architecture diagrams, and more. Features 50+ pre-built templates, advanced layout engines, and exports to SVG/PNG/PDF. Works seamlessly with GitHub Copilot, Claude, Cursor, and any MCP-compatible client. - **NPM:** `npm install @narasimhaponnada/mermaid-mcp-server` - **Key Features:** - 🎨 22+ diagram types (flowchart, sequence, class, ER, state, gantt, architecture, etc.) - 📚 50+ production-ready templates - 🤖 Natural language to professional diagrams - ⚡ Browser-based rendering with Puppeteer for XML-compliant SVGs - 🔧 Multiple integration methods (VS Code, Claude Desktop, CLI, API) - 📊 Advanced features: custom themes, interactive diagrams, multi-format export ``` ## Additional Information ### Why This Server is Valuable 1. **Comprehensive Solution**: Most complete Mermaid diagram generation via MCP 2. **Production-Ready**: XML-validated SVG outputs, battle-tested 3. **Well-Documented**: 807-line setup guide + 2,349-line user guide 4. **Active Development**: Regular updates and bug fixes 5. **Community-Friendly**: MIT license, contribution guidelines included ### Statistics - ⭐ GitHub Stars: [Current count] - 📦 NPM Downloads: [Publishing soon] - 📝 Lines of Code: 15,692 - 📚 Documentation: 3,000+ lines - 🎨 Sample Diagrams: 5 production SVGs included ### Links - **Repository**: https://github.com/Narasimhaponnada/mermaid-mcp - **NPM Package**: `@narasimhaponnada/mermaid-mcp-server` - **Setup Guide**: [Setup.md](https://github.com/Narasimhaponnada/mermaid-mcp/blob/main/Setup.md) - **User Guide**: [UserGuide.md](https://github.com/Narasimhaponnada/mermaid-mcp/blob/main/UserGuide.md) - **Live Examples**: [examples/architectures/](https://github.com/Narasimhaponnada/mermaid-mcp/tree/main/mermaid-mcp-server/examples/architectures) ### Supported Diagram Types 1. Flowcharts & Process Diagrams 2. Sequence Diagrams 3. Class Diagrams 4. Entity-Relationship Diagrams 5. State Diagrams 6. Gantt Charts 7. User Journeys 8. Timelines 9. Mindmaps 10. Architecture Diagrams 11. C4 Diagrams 12. Pie Charts 13. XY Charts 14. Sankey Diagrams 15. Radar Charts 16. Quadrant Charts 17. Requirement Diagrams 18. Kanban Boards 19. Git Graphs 20. Block Diagrams 21. Packet Diagrams 22. Treemaps ### Integration Examples **GitHub Copilot:** ``` User: Create a microservices architecture diagram Copilot: [Calls MCP] [Generates professional diagram] ``` **Claude Desktop:** ``` User: Generate a CI/CD pipeline flowchart Claude: [Uses MCP] [Returns SVG + Mermaid code] ``` **Direct CLI:** ```bash node generate-svg-samples.js # Generates 5 production-ready architecture diagrams ```