🚀 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

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.md) - 🎯 How to use this MCP in Claude (commands, examples)
• [examples/usage-examples.ts](./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