# Cleanor

Cleanor gives coding agents tools for image processing and deterministic developer tasks. Use it to optimize an image, format JSON, or inspect a cron expression.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: cleanor-app
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cleanor-app/cleanor-mcp
- Updated: 2026-10-07
- HTML: https://affpapa.org/en/nevibecode/mcp/cleanor

## What it does

Cleanor exposes tools to re-encode images from public URLs, create SVG placeholders, and generate QR codes. It also provides storage and image-format figures, plus utilities such as JSON formatting, UUID generation, and unit conversion. Tool responses include structured data.

Connect to the hosted server over HTTP without an API key, account, or OAuth flow. A local npm option is available; local image encoding uses the optional `sharp` dependency. The image optimizer accepts inputs up to 25 MB. One limitation matters: `jwt_decode` reads a token’s header and payload but does not verify its signature, so it cannot establish that the token is authentic.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.cleanor.app/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http cleanor https://mcp.cleanor.app/mcp
```

2. **Platform CLI**
```bash
claude mcp add cleanor -- npx -y @cleanor/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add cleanor --url https://mcp.cleanor.app/mcp
```

2. **Platform CLI**
```bash
codex mcp add cleanor -- npx -y @cleanor/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cleanor": {
            "url": "https://mcp.cleanor.app/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cleanor": {
            "command": "npx",
            "args": [
                "-y",
                "@cleanor/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cleanor": {
            "type": "http",
            "url": "https://mcp.cleanor.app/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cleanor": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@cleanor/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http cleanor https://mcp.cleanor.app/mcp
```

2. **Platform CLI**
```bash
gemini mcp add cleanor npx -y @cleanor/mcp
```

## When to use it
- shrink an image fetched from a public URL
- create an SVG placeholder or QR code
- validate and format JSON
- generate a hash, HMAC, or UUID
- convert a value between measurement units

## Example prompts
- Optimize this image from its public URL and report the before-and-after sizes.
- Check this JSON, format it, and sort its keys.
- Explain this cron expression and list its upcoming run times.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md