code-quality-mcp

🚀 Code Quality MCP Server

Hybrid Code Quality Analysis - Combines logic-based checks with AI-powered deep analysis

MCP (Model Context Protocol) system for code quality analysis. Supports two modes:

• ⚡ Fast Mode: Quick logic-based checks
• 🤖 Deep Mode: AI-powered deep analysis (Claude)

---

🔧 Installation

npm install
npm run build

▶️ Running the Server

Option 1: Direct Run

npm start

Option 2: Via Claude Desktop

Add to ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "code-quality": {
      "command": "node",
      "args": ["/absolute/path/to/code-quality-mcp/dist/index.js"]
    }
  }
}

---

📚 API Tools

🔍 Analysis Tools

1. check_quality - Full Code Quality Check

{
  "tool": "check_quality",
  "arguments": {
    "projectPath": ".",
    "deepAnalysis": false,     // true = AI mode
    "checkUnusedCode": true,
    "checkComplexity": false,  // requires AI
    "checkSecurity": false,    // requires AI
    "page": 1,                 // pagination
    "pageSize": 50             // items per page
  }
}

Returns: Complete list of issues with pagination

---

💡 Smart Tools (Recommended!)

2. get_smart_summary - Smart Summary ⭐

Instead of 500 issues, get a focused summary:

{
  "tool": "get_smart_summary",
  "arguments": {
    "projectPath": "."
  }
}

Returns: ``` 📊 Score: 68/100 📈 Issues: 500 (120 critical) ⏱️ Fix Time: 2 days

🔥 Top Problems: • unused-code: 300 (60%) • security: 50 (10%)

📁 Hotspot Files: 🔴 UserService.ts - 45 issues ```

---

3. get_quick_wins - Quick Wins ⚡

Get only actions that provide maximum impact in minimum time:

{
  "tool": "get_quick_wins",
  "arguments": {
    "projectPath": "."
  }
}

Returns: ``` ⚡ Quick Wins:

1. Remove 50 unused vars (10 min) → +15 points
2. Fix 30 console.log (5 min) → +8 points
3. Translate Hebrew comments (15 min) → +5 points

Total: 30 minutes → +28 points! ```

---

4. get_trends - Progress Tracking 📈

See how code quality improves over time:

{
  "tool": "get_trends",
  "arguments": {
    "projectPath": "."
  }
}

Returns: ``` 📈 Trends: ✅ Score: 45 → 68 (+23) ✅ Fixed: 120 issues ⚠️ New: 15 issues

Improving: • unused-code: 300 → 180 (-120) • security: 10 → 5 (-5)

Degrading: • code-style: 50 → 65 (+15) ```

---

🔧 Other Tools

5. analyze_project - Project Type Detection

{
  "tool": "analyze_project",
  "arguments": {
    "projectPath": ".",
    "deep": true
  }
}

6. get_recommendations - Quick Recommendations

{
  "tool": "get_recommendations",
  "arguments": {
    "projectPath": ".",
    "language": "en"  // or "he" for Hebrew
  }
}

---

⚡ Fast vs Deep Mode

| Feature | Fast Mode | Deep Mode | |---------|-----------|-----------| | Speed | ~20ms | ~1000ms | | Cost | Free | API calls | | Accuracy | Good | Excellent | | AI insights | ❌ | ✅ |

When to use Fast Mode:

• During development
• Before commits
• In CI/CD pipelines

When to use Deep Mode:

• Before Pull Requests
• Code reviews
• Security audits

---

📖 Examples

• HOW_TO_USE.md - 🎯 How to use this MCP in Claude (commands, examples)
• examples/usage-examples.ts - Complete API examples

---

🌍 Supported Platforms

• Node.js / TypeScript
• React / React Native
• Next.js / NestJS
• Firebase / AWS Amplify
• Java / .NET / Angular

---

🚀 Key Features

✅ Smart Ignore Patterns - Automatically skips:

• node_modules, build, dist, .git
• React Native: android/gradle, ios/Pods, native build folders
• Only scans your code, not auto-generated files

✅ Pagination - Handle large projects with many issues

✅ Smart Summaries - Get actionable insights instead of overwhelming lists

✅ Quick Wins - Find high-impact, low-effort fixes

✅ Trend Tracking - Monitor code quality improvements over time

---

Built with ❤️ using MCP and Claude