Cleanor Tools

MCP开发工具

提供方 cleanor-app

开发工具 HTTP · 远程 API Key 社区 / 第三方 Claude DesktopClaudeCursorVS Code
查看接入方式

Zero-auth hosted MCP for AI builders — 22 tools: image optimize/convert (WebP/AVIF/JPEG), QR, cited Cleanor Labs storage & image-format data, plus 18 deterministic dev utilities (hash, HMAC, UUID, JWT, JSON, regex, cron, datetime, color, diff…) LLMs get wrong. No API key.

一句话选型结论

按资料字段整理

Cleanor Tools 属于开发工具类 MCP 服务器,HTTP · 远程,API Key,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式HTTP · 远程 鉴权API Key 部署方式远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

qr code storage ai tools

支持客户端

适用场景

qr codestorageai tools

安装与配置

HTTP · 远程 API Key
连远程 HTTPS 端点,通常为 Streamable HTTP
https://mcp.cleanor.app/mcp

把它填进客户端的 MCP 配置即可,不需要在本地安装运行时。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Cleanor Tools当前 未标注 HTTP · 远程 远程部署 有 未标注
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方cleanor-app上游标注的维护方 cleanor-app
分类开发工具本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · node本地安装时用到的包标识与运行时
部署类型远程部署上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

12.2 KB
来自项目仓库与上游目录的原文,未做删改

Cleanor MCP: a zero-auth MCP server for image optimization and dev utilities

A hosted, zero-auth MCP server with 22 tools: optimize and convert images, generate QR codes, and run the deterministic dev utilities LLMs get wrong.

No API key. No signup. No OAuth. Point any Model Context Protocol client at one URL and 22 tools appear, all read-only and safe to hand to an autonomous agent.

Streamable HTTP endpoint · https://mcp.cleanor.app/mcp
npm package (stdio) · @cleanor/mcp
Official MCP Registry · app.cleanor/cleanor
Homepage · cleanor.app/mcp
Auth · none
Tools · 22
Version · 0.6.0

Install

Pick your client. Every option below points at the same hosted server, so there is nothing to build, install or key.

Claude Code```bash

claude mcp add --transport http cleanor https://mcp.cleanor.app/mcp


Then run `claude mcp list` to confirm it connected. Full walkthrough: docs/add-an-mcp-server-to-claude-code.md.

### Cursor

Add to `.cursor/mcp.json` (per project) or `~/.cursor/mcp.json` (global):```json
{
  "mcpServers": {
    "cleanor": {
      "url": "https://mcp.cleanor.app/mcp"
    }
  }
}

VS Code

Run code --add-mcp '{"name":"cleanor","type":"http","url":"https://mcp.cleanor.app/mcp"}', or add the server to .vscode/mcp.json in the workspace:```json
{
"servers": {
"cleanor": {
"type": "http",
"url": "https://mcp.cleanor.app/mcp"
}
}
}


### Claude Desktop

Open Settings, then Connectors, then "Add custom connector", and paste the endpoint:```
https://mcp.cleanor.app/mcp

Or run the server locally over stdio from claude_desktop_config.json:```json
{
"mcpServers": {
"cleanor": {
"command": "npx",
"args": ["-y", "@cleanor/mcp"]
}
}
}


The npm build is the same tool registry compiled for Node. It uses `sharp` (an optional dependency) for local image encoding; the other 21 tools need nothing.

### Raw Streamable HTTP

The endpoint speaks the MCP Streamable HTTP transport, so you can drive it with `curl` or any HTTP client:```bash
curl -s https://mcp.cleanor.app/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1"}}}'

There is also a plain REST surface for non-MCP callers: GET /v1/capabilities (feature detection, machine-readable tool list) and POST /v1/optimize (one image in, optimized bytes out).

Tools

22 tools, every one of them carrying an input and an output schema, so a client gets typed structuredContent back and not just a wall of text.

Image

Tool · What it does · Key params
optimize_image · Fetches an image from a public URL and re-encodes it smaller. Returns the optimized image plus before and after byte counts. Input capped at 25 MB. · image_url (required), format (webp \ · avif \ · jpeg, default webp), width (16 to 4096 px, optional), quality (1 to 100, default 80)
placeholder_image · Dependency-free SVG placeholder at any size, with a label and custom colors. · width (default 600), height (default 400), bg, color, text
qr_code · Encodes text or a URL as a crisp SVG QR code you can paste anywhere. · text (required, up to 2000 chars), ecc (L \ · M \ · Q \ · H, default M), size (64 to 1024, default 320)

Cited data (Cleanor Labs research)

Tool · What it does · Key params
storage_capacity · How many photos or minutes of video actually fit in a storage tier, corrected for real OS and filesystem overhead. Returns a per-format breakdown. · storage_gb (required, 1 to 4096), content (photos \ · video, default photos)
image_format_savings · How much smaller WebP, AVIF or JPEG XL are than JPEG at matched perceptual quality, from a controlled benchmark on the 24-image Kodak suite. Also reports the HEIC conversion tax. · format (webp \ · avif \ · jxl, default avif), quality (web = SSIM 0.95, high = SSIM 0.98, default web)

Dev utilities

The operations an LLM is unreliable at: hashing, counting, radix math, timezones. Pure compute, no network, no state.

Tool · What it does · Key params
hash · SHA-1/256/384/512 hex digest of text. MD5 is deliberately not offered. · input (required), algorithm (default sha-256)
hmac · Keyed HMAC signature, hex or Base64. For signing and verifying webhooks. · message (required), secret (required), algorithm (default sha-256), encoding (hex \ · base64)
uuid · UUID v4 (random) or v7 (time-sortable, the better database key). · version (v4 \ · v7, default v4), count (1 to 100)
base64 · Base64 encode or decode, UTF-8 safe, optional URL-safe alphabet. · input (required), mode (encode \ · decode), url_safe (boolean)
json_format · Validates JSON, then pretty-prints or minifies it, optionally deep-sorting keys. Returns a precise parse error if invalid. · input (required), mode (pretty \ · minify), sort_keys (boolean)
jwt_decode · Decodes a JWT header and payload and flags expiry. The signature is not verified and no secret is needed. · token (required)
regex_test · Runs a JavaScript regex against sample text and returns every match with its index and captured groups (first 100). · pattern (required), input (required), flags (default g)
cron_describe · Explains a 5-field cron expression in plain English and lists the next 5 run times in UTC. · expression (required)
unit_convert · Exact conversion across length, mass, data size, time, speed and temperature. · value (required), from (required), to (required)
datetime · The real current time, or any timestamp, rendered in an IANA timezone as ISO, Unix and human forms. · input (optional Unix timestamp or ISO string), timezone (default UTC)
url_parse · Splits a URL into scheme, host, port, path, decoded query params and fragment. · url (required)
base_convert · Integer conversion between bases 2 and 36, BigInt-exact so large values stay exact. · value (required), from_base (default 10), to_base (default 16)
diff · Line-by-line diff of two texts with an added and removed count. Up to 1000 lines per side. · a (required), b (required)
color · Converts one color into hex, RGB and HSL at once. Accepts hex, rgb(), hsl() and CSS names. · value (required)
color_palette · Derives a harmonious palette from one base color. · color (required), harmony (complementary \ · analogous \ · triadic \ · tetradic \ · monochromatic)
slugify · Clean, URL-safe slug from a title: lowercased, hyphenated, accents stripped. · input (required), separator (- \ · _)
count · Exact characters (code points), UTF-16 units, words, lines and UTF-8 bytes. · input (required)

Every tool is annotated readOnlyHint: true. Only optimize_image touches the network (openWorldHint: true); the other 21 are pure functions of their input.

Full input and output schemas: docs/mcp-tools-reference.md.

Tool index (CSV)

data/tools.csv is the same 22 tools as a flat, machine-readable table: name, title, category (image, data, dev), summary, required and optional parameters, and output fields. Handy for diffing releases, feeding an MCP directory, or comparing this server against another.

The file is generated, not hand-written: every value is read out of the tool's Zod schema in src/tools/. If you add or change a tool, regenerate it.bash npm run tools:csv # rewrite data/tools.csv from src/tools/ npm run tools:csv:check # exit 1 if data/tools.csv is out of date

Docs

Page What it answers
How to add an MCP server to Claude Code The claude mcp add command for stdio, HTTP and SSE servers, the three config scopes, and how to debug a server that will not connect.
MCP server for image optimization How to let an AI agent compress and convert images (WebP, AVIF, JPEG) through MCP, and the measured savings per format.
MCP tools reference All 22 tools, one section each, with the complete input and output schema and an example call.

FAQ

Is Cleanor MCP free?

Yes. It is free to use, with no account, no API key and no paid tier. The hosted endpoint is rate-limited per IP (120 requests per minute in general, 30 per minute for image optimization) so one client cannot starve the rest, and the source is MIT licensed if you would rather run it yourself.

Does it need an API key?

No. Auth is none, which you can verify for yourself at GET https://mcp.cleanor.app/v1/capabilities. There is no signup, no OAuth flow and no token to rotate. Point your client at https://mcp.cleanor.app/mcp and start calling tools.

What data does it send?

Only what you pass to a tool. 21 of the 22 tools are pure functions evaluated on the server, and optimize_image additionally fetches the public image URL you hand it. There is no account, no user identifier, and no database or object store in the server: it is a single Cloudflare Worker with no persistence binding for your inputs. If your data is sensitive, run the stdio build locally with npx -y @cleanor/mcp and nothing leaves your machine.

Can I self-host it?

Yes, in two ways. Run it locally over stdio with npx -y @cleanor/mcp (the same tool registry, with sharp doing the image encoding instead of Cloudflare Images), or deploy this repo to your own Cloudflare account with wrangler deploy, since the Worker entry point and wrangler.jsonc are both in the tree. The Dockerfile builds the stdio server for registries and scanners that prefer to start it themselves.

How is a hosted MCP server different from a local MCP server?

A local (stdio) server is a process your client spawns on your machine: it can reach your filesystem, but you have to install it, keep it updated and carry its dependencies. A hosted (Streamable HTTP) server is just a URL: no install, no version drift, and the heavy work runs on someone else's CPU. Cleanor MCP is offered both ways, and the hosted endpoint is the one to prefer for image optimization, because Cloudflare Images does the encoding and you never install sharp.

Which clients work with it?

Any MCP client that speaks Streamable HTTP: Claude Code, Claude Desktop (as a custom connector), Cursor, VS Code, and the agent frameworks with MCP support. Clients that only speak stdio can run the npm package instead. Both paths expose the identical 22 tools, because both register the same tool array from src/tools/.

Where does the research data come from?

storage_capacity and image_format_savings return numbers from Cleanor Labs' published studies, not from model memory. The format savings come from a controlled benchmark on the 24-image Kodak lossless suite at matched SSIM; the storage numbers come from measured per-item file sizes plus real OS overhead. Every response links its source page on cleanor.app/research.

Related projects

Repo What it is
cleanor-app/browser-image-tools The in-browser image compression and conversion engine behind cleanor.app.
cleanor-app/image-compressor-chrome-extension Chrome extension: compress, convert and capture images without leaving the page.
cleanor-app/wordpress-image-optimizer WordPress plugin that optimizes and converts your media library.
cleanor-app/cleanor-storage-lab The open benchmarks behind the storage and image-format studies.
cleanor-app/search-index Open dataset of monthly search demand, the source for the Cleanor trends studies.

Built by Cleanor Labs

Cleanor is a set of free, private browser tools (files never leave your device) plus original research on device storage and image formats. This MCP server is a thin front door to that toolset and that data, for AI agents.

  • Free browser tools: https://cleanor.app/tools
  • Research and studies: https://cleanor.app/research
  • MCP homepage: https://cleanor.app/mcp

License

MIT, Cleanor Labs.

Citation

If you use Cleanor MCP or its data, please cite it. Authored by Cleanor Labs, ORCID 0009-0005-4623-961X. The archived, citable version has DOI 10.5281/zenodo.21225551, a concept DOI that always resolves to the latest release. Machine-readable metadata lives in CITATION.cff.

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Cleanor Tools 怎么安装?

在客户端按下面的安装命令接入:https://mcp.cleanor.app/mcp。装完在客户端配置里引用同一个包或端点。

Cleanor Tools 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是HTTP · 远程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Cleanor Tools 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Cleanor Tools 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Cleanor Tools 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、VS Code、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Cleanor Tools 能提供哪些能力?

资料显示能力标签包括 qr code、storage、ai tools。具体工具清单以官方文档为准。

Cleanor Tools 需要什么运行环境?

运行时为 node;属于远程端点,不需要在本地装运行时。

Cleanor Tools 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。