JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 38
  • Score
    100M100P100Q100408F
  • License MIT

Architecture Analyzer MCP - Detect circular dependencies, layer violations, and generate dependency graphs. Works with Claude Code, Cursor, Windsurf, Roo Code, and any MCP-compatible editor.

Package Exports

  • @j0kz/architecture-analyzer-mcp
  • @j0kz/architecture-analyzer-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@j0kz/architecture-analyzer-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@j0kz/architecture-analyzer-mcp

Detect circular dependencies, layer violations, and generate dependency graphs

npm version License: MIT

🚀 Quick Start (30 seconds)

One-Time Setup

Pick your editor and run ONE command:

Claude Code:

claude mcp add architecture-analyzer "npx @j0kz/architecture-analyzer-mcp" --scope user

Cursor: Add to ~/.cursor/mcp_config.json

{
  "mcpServers": {
    "architecture-analyzer": {
      "command": "npx",
      "args": ["@j0kz/architecture-analyzer-mcp"]
    }
  }
}

Windsurf / Roo Code / Continue: Similar config - see full guide

Start Using Immediately

After setup, just chat naturally with your AI:

💬 You: "Analyze project architecture"
🤖 AI: *Scans codebase* Found: 2 circular dependencies (auth ↔ user), 3 layer violations (UI calls Database directly)...

💬 You: "Generate dependency graph for src/services"
🤖 AI: *Creates Mermaid diagram* [Shows visual graph] AuthService → UserService → Database, PaymentService → External API...

💬 You: "What architectural issues should I fix first?"
🤖 AI: Priority 1: Break circular dependency in auth module. Priority 2: Add service layer between UI and Database...

✨ Features

🔍 Circular Dependency Detection - Find and break dependency cycles 📐 Layer Violation Analysis - Enforce clean architecture 📊 Visual Dependency Graphs - Mermaid diagrams of your code structure 🎯 Refactoring Suggestions - Actionable improvement recommendations

📦 Complete @j0kz MCP Suite

Get all 8 professional development tools - install individually or all at once:

# 🎯 Code Quality Suite
npx @j0kz/smart-reviewer-mcp      # AI code review
npx @j0kz/test-generator-mcp      # Auto-generate tests
npx @j0kz/refactor-assistant-mcp  # Refactoring help

# 🏗️ Architecture & Design
npx @j0kz/architecture-analyzer-mcp  # Architecture analysis
npx @j0kz/api-designer-mcp           # API design
npx @j0kz/db-schema-mcp              # Database schemas

# 📚 Documentation & Security
npx @j0kz/doc-generator-mcp       # Auto-generate docs
npx @j0kz/security-scanner-mcp    # Security scanning

👉 View complete collection on GitHub

🎯 How It Works

  1. Install once - Run the setup command for your editor
  2. Restart editor - Reload to activate the MCP
  3. Chat naturally - Just ask your AI assistant to help
  4. Get results - The MCP tools work behind the scenes

No configuration files, no complex setup, no API keys needed!

🔧 Editor Support

Editor Status Notes
Claude Code ✅ Full support Recommended
Cursor ✅ Full support Native MCP
Windsurf ✅ Full support Built-in MCP
Roo Code ✅ Full support MCP compatible
Continue ✅ Full support MCP plugin
Zed ✅ Full support MCP support

Any MCP-compatible editor works!

❓ Troubleshooting

MCP not showing up?

  • Restart your editor after installation
  • Check: claude mcp list (Claude Code) to verify connection

Commands not working?

  • Make sure Node.js is installed (node --version)
  • Try reinstalling: Remove and re-add the MCP

Still stuck?

📄 License

MIT © j0kz

Explore more tools: github.com/j0kz/mcp-agents | npm: @j0kz