# 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

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

### Option 2: npm (if published)

```bash
npm install -g deslop-mcp
```

## Configuration

### For Cursor

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

```json
{
  "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):

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

### For Claude Code

Add to your Claude Code MCP settings:

```json
{
  "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

```markdown
# 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