deslop-mcp

An MCP (Model Context Protocol) server that detects and removes AI-generated code slop patterns.

Works with Cursor, Claude Desktop, Claude Code, and any MCP-compatible client.

What is "Slop"?

AI-generated code often includes patterns that hurt maintainability:

• Comment slop: Comments that restate what code does ("This function gets the user")
• Verbose logging: Entry/exit logs, debug statements left in production
• Unnecessary error handling: Try-catch that only logs and re-throws
• Defensive overkill: Redundant null checks in TypeScript
• Async misuse: async functions with no await
• Unused imports: Dead code from refactoring

Installation

Option 1: Clone from GitHub

git clone https://github.com/YOUR_USERNAME/deslop-mcp.git
cd deslop-mcp
npm install
npm run build

Option 2: npm (if published)

npm install -g deslop-mcp

Configuration

For Cursor

Add to your Cursor MCP settings (~/.cursor/mcp.json or via Settings > MCP):

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

For Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

For Claude Code

Add to your Claude Code MCP settings:

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

Tools

deslop_analyze

Analyze code files for slop patterns.

deslop_analyze({ path: "./src" })
deslop_analyze({ path: "./src/utils/api.ts" })

Returns a detailed report with:

• Issues grouped by category
• Priority levels (high/medium/low)
• Line numbers for each issue
• Auto-fixable indicators

deslop_fix

Automatically fix auto-fixable issues.

deslop_fix({ path: "./src" })
deslop_fix({ path: "./src", dryRun: true })  // Preview without changes

deslop_diff

Analyze only changed files from git.

deslop_diff({})                    // Unstaged changes
deslop_diff({ staged: true })      // Staged changes only

Example Output

# Deslop Analysis Report

## Summary
- 🔴 High Priority: 12 issues
- 🟡 Medium Priority: 5 issues
- 🔵 Low Priority: 2 issues
- 🔧 Auto-fixable: 10 issues

## src/services/userService.ts

### 🔴 Comment Slop (3)

- **Line 45**: Comment restates what code does instead of why
  `// This function gets the user from the database`
  *(auto-fixable)*

- **Line 78**: Commented-out code should be removed
  `// const oldUser = await getOldUser(id);`
  *(auto-fixable)*

### 🔴 Verbose Logging (2)

- **Line 23**: Debug/trace logging should be removed in production
  `console.log("Entering getUserById");`
  *(auto-fixable)*

Supported Languages

• TypeScript (.ts, .tsx)
• JavaScript (.js, .jsx)
• Python (.py)
• Java (.java)
• Go (.go)
• Rust (.rs)

Safety

The tool will never remove:

• Error logging that captures actual errors
• Comments explaining business logic or "why"
• License headers or copyright notices
• TODO comments with ticket references

License

MIT