Cleanor Tools

Cleanor MCP：用于图像优化和开发实用工具的零认证 MCP 服务

托管式零认证 MCP 服务，提供 22 个工具：优化和转换图像、生成 QR 码，以及运行大模型容易出错的确定性开发实用工具。

无需 API 密钥、无需注册、无需 OAuth。让任意 Model Context Protocol 客户端连接到一个 URL，即可使用 22 个工具；它们全部只读，可放心交由自主 Agent 使用。

Streamable HTTP 端点	https://mcp.cleanor.app/mcp
npm 包（stdio）	@cleanor/mcp
官方 MCP Registry	app.cleanor/cleanor
主页	cleanor.app/mcp
认证	无
工具	22
版本	0.6.0

安装

选择你的客户端。以下每种方式都连接到同一个托管服务，因此无需构建、安装或配置密钥。

Claude Code

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

然后运行 claude mcp list，确认连接成功。完整操作指南：docs/add-an-mcp-server-to-claude-code.md。

Cursor

添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "cleanor": {
      "url": "https://mcp.cleanor.app/mcp"
    }
  }
}

VS Code

运行 code --add-mcp '{"name":"cleanor","type":"http","url":"https://mcp.cleanor.app/mcp"}'，或将服务添加到工作区中的 .vscode/mcp.json：

{
  "servers": {
    "cleanor": {
      "type": "http",
      "url": "https://mcp.cleanor.app/mcp"
    }
  }
}

Claude Desktop

打开 Settings，然后选择 Connectors，再选择“Add custom connector”，并粘贴端点：

https://mcp.cleanor.app/mcp

也可以通过 claude_desktop_config.json 在本地使用 stdio 运行服务：

{
  "mcpServers": {
    "cleanor": {
      "command": "npx",
      "args": ["-y", "@cleanor/mcp"]
    }
  }
}

npm 构建版本是为 Node 编译的同一套工具注册表。它使用 sharp（可选依赖）在本地编码图像；其余 21 个工具无需依赖。

原始 Streamable HTTP

该端点使用 MCP Streamable HTTP 传输，因此你可以通过 curl 或任何 HTTP 客户端调用：

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"}}}'

此外还提供面向非 MCP 调用方的纯 REST 接口：GET /v1/capabilities（功能检测、机器可读的工具列表）和 POST /v1/optimize（输入一张图像，输出优化后的字节数据）。

工具

22 个工具均包含输入和输出 schema，因此客户端可以获取类型化的 structuredContent，而不只是收到一大段文本。

图像

工具	功能	关键参数
optimize_image	从公开 URL 获取图像并重新编码以缩小体积。返回优化后的图像以及优化前后的字节数。输入上限为 25 MB。	image_url（必填）、format（webp | avif | jpeg，默认 webp）、width（16 至 4096 px，可选）、quality（1 至 100，默认 80）
placeholder_image	无需依赖即可生成任意尺寸的 SVG 占位图，并支持标签和自定义颜色。	width（默认 600）、height（默认 400）、bg、color、text
qr_code	将文本或 URL 编码为清晰的 SVG QR 码，可粘贴到任意位置。	text（必填，最多 2000 个字符）、ecc（L | M | Q | H，默认 M）、size（64 至 1024，默认 320）

引用数据（Cleanor Labs 研究）

工具	功能	关键参数
storage_capacity	计算存储空间档位实际可容纳的照片数量或视频时长，并扣除实际操作系统和文件系统开销。返回各格式的细分数据。	storage_gb（必填，1 到 4096），content（photos | video，默认 photos）
image_format_savings	根据对 24 张图片组成的 Kodak 套件进行的受控基准测试，比较 WebP、AVIF 或 JPEG XL 在感知质量相同时比 JPEG 小多少。还会报告 HEIC 转换损耗。	format（webp | avif | jxl，默认 avif），quality（web = SSIM 0.95，high = SSIM 0.98，默认 web）

开发工具

LLM 难以可靠完成的操作：哈希、计数、进制运算、时区。纯计算，不联网、不保存状态。

工具	功能	关键参数
hash	计算文本的 SHA-1/256/384/512 十六进制摘要。特意不提供 MD5。	input（必填），algorithm（默认 sha-256）
hmac	计算带密钥的 HMAC 签名，支持十六进制或 Base64。用于签名和验证 Webhook。	message（必填），secret（必填），algorithm（默认 sha-256），encoding（hex | base64）
uuid	UUID v4（随机）或 v7（可按时间排序，更适合作为数据库键）。	version（v4 | v7，默认 v4），count（1 到 100）
base64	对数据进行 Base64 编码或解码，安全处理 UTF-8，可选 URL 安全字符集。	input（必填），mode（encode | decode），url_safe（布尔值）
json_format	验证 JSON，然后对其进行美化或压缩，可选深度排序键。若无效，会返回精确的解析错误。	input（必填），mode（pretty | minify），sort_keys（布尔值）
jwt_decode	解码 JWT 标头和载荷，并标记是否过期。不会验证签名，也无需密钥。	token（必填）
regex_test	使用 JavaScript 正则表达式匹配示例文本，并返回每个匹配项及其索引和捕获组（最多 100 个）。	pattern（必填），input（必填），flags（默认 g）
cron_describe	用通俗英语解释 5 字段 cron 表达式，并列出接下来 5 次运行时间（UTC）。	expression（必填）
unit_convert	在长度、质量、数据大小、时间、速度和温度单位之间进行精确换算。	value（必填），from（必填），to（必填）
datetime	获取当前实际时间或任意时间戳，并以 IANA 时区呈现为 ISO、Unix 和易读格式。	input（可选的 Unix 时间戳或 ISO 字符串），timezone（默认 UTC）
url_parse	将 URL 拆分为 scheme、host、port、path、解码后的查询参数和 fragment。	url（必填）
base_convert	在 2 到 36 进制之间转换整数，精确使用 BigInt，因此大数值也能保持精确。	value（必填），from_base（默认 10），to_base（默认 16）
diff	逐行比较两段文本，并统计新增和删除行数。每段最多 1000 行。	a（必填），b（必填）
color	将一种颜色同时转换为十六进制、RGB 和 HSL。接受十六进制、rgb()、hsl() 和 CSS 颜色名称。	value（必填）
color_palette	根据一种基色生成协调配色方案。	color（必填），harmony（complementary | analogous | triadic | tetradic | monochromatic）
slugify	根据标题生成简洁、安全的 URL slug：转为小写、使用连字符分隔并移除重音符号。	input（必填），separator（- | _）
count	精确统计字符数（码点）、UTF-16 单元数、单词数、行数和 UTF-8 字节数。	input（必填）

每个工具均标注为 readOnlyHint: true。只有 optimize_image 会访问网络（openWorldHint: true）；其余 21 个工具都是仅依赖输入的纯函数。

完整的输入和输出架构：docs/mcp-tools-reference.md。

工具索引（CSV）

data/tools.csv 以扁平、机器可读的表格列出相同的 22 个工具：名称、标题、类别（image、data、dev）、摘要、必需和可选参数，以及输出字段。适合用于比较版本差异、导入 MCP 目录，或将此服务与其他服务进行比较。

该文件由程序生成，而非手动编写：每个值都从 src/tools/ 中工具的 Zod 架构读取。添加或更改工具后，请重新生成该文件。

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

文档

页面	解答的问题
如何将 MCP 服务添加到 Claude Code	用于 stdio、HTTP 和 SSE 服务的 claude mcp add 命令、三种配置范围，以及如何排查服务无法连接的问题。
用于图像优化的 MCP 服务	如何通过 MCP 让 AI Agent 压缩和转换图像（WebP、AVIF、JPEG），以及各格式经测量得出的节省空间数据。
MCP 工具参考	全部 22 个工具，每个工具各占一节，包含完整的输入和输出架构及调用示例。

常见问题

Cleanor MCP 免费吗？

是的。它可免费使用，无需账号、API 密钥，也没有付费套餐。托管端点按 IP 限流（通常每分钟 120 个请求，图像优化每分钟 30 个请求），以免某个客户端占用过多资源、影响其他客户端；如果你更愿意自行运行，源代码采用 MIT 许可证。

需要 API 密钥吗？

不需要。身份验证方式为 none，你可以通过 GET https://mcp.cleanor.app/v1/capabilities 自行验证。无需注册，没有 OAuth 流程，也没有需要轮换的令牌。将客户端指向 https://mcp.cleanor.app/mcp，即可开始调用工具。

它会发送哪些数据？

只会发送你传给工具的数据。22 个工具中有 21 个是在服务端执行的纯函数，optimize_image 还会获取你提供的公开图像 URL。服务端没有账号、用户标识符、数据库或对象存储：它是一个独立的 Cloudflare Worker，没有用于存储输入内容的持久化绑定。如果你的数据敏感，可使用 npx -y @cleanor/mcp 在本地运行 stdio 版本，数据不会离开你的设备。

可以自行托管吗？

可以，有两种方式。通过 npx -y @cleanor/mcp 在本地以 stdio 方式运行（使用相同的工具注册表，并由 sharp 而非 Cloudflare Images 执行图像编码）；或者使用 wrangler deploy 将此代码库部署到你自己的 Cloudflare 账号，因为 Worker 入口点和 wrangler.jsonc 都包含在代码库中。对于更愿意自行启动服务的目录和扫描器，Dockerfile 可用于构建 stdio 服务。

托管的 MCP 服务与本地 MCP 服务有什么区别？

本地（stdio）服务是由客户端在你的设备上启动的进程：它可以访问你的文件系统，但你必须安装它、保持更新并管理其依赖项。托管的（Streamable HTTP）服务只有一个 URL：无需安装，不会出现版本偏差，繁重的工作则由他人的 CPU 执行。Cleanor MCP 同时提供这两种方式；图像优化更适合使用托管端点，因为编码由 Cloudflare Images 完成，你无需安装 sharp。

哪些客户端可以使用它？

任何支持 Streamable HTTP 的 MCP 客户端都可以使用：Claude Code、Claude Desktop（作为自定义连接器）、Cursor、VS Code，以及支持 MCP 的 Agent 框架。仅支持 stdio 的客户端可以改用 npm 包。两种方式都提供完全相同的 22 个工具，因为它们都从 src/tools/ 注册同一个工具数组。

研究数据来自哪里？

storage_capacity 和 image_format_savings 返回的是 Cleanor Labs 已发布研究中的数据，而非模型记忆中的内容。格式节省数据来自使用 24 张图像的 Kodak 无损套件进行的受控基准测试，且 SSIM 保持一致；存储数据则来自每项文件大小的实测值及真实操作系统开销。每个响应都会链接到 cleanor.app/research 上的来源页面。

相关项目

仓库	项目简介
cleanor-app/browser-image-tools	cleanor.app 背后的浏览器内图像压缩和转换引擎。
cleanor-app/image-compressor-chrome-extension	Chrome 扩展：无需离开页面，即可压缩、转换和捕获图像。
cleanor-app/wordpress-image-optimizer	可优化和转换媒体库的 WordPress 插件。
cleanor-app/cleanor-storage-lab	关于存储和图像格式研究的开源基准测试。
cleanor-app/search-index	月度搜索需求的开放数据集，也是 Cleanor 趋势研究的数据来源。

由 Cleanor Labs 构建

Cleanor 提供一系列免费且私密的浏览器工具（文件不会离开你的设备），以及有关设备存储和图像格式的原创研究。这个 MCP 服务是面向 AI Agent 的轻量入口，可访问这些工具和数据。

• 免费浏览器工具：https://cleanor.app/tools
• 研究与分析：https://cleanor.app/research
• MCP 主页：https://cleanor.app/mcp

许可证

MIT，Cleanor Labs。

引用

如果你使用 Cleanor MCP 或其数据，请注明出处。作者：Cleanor Labs，ORCID 0009-0005-4623-961X。已存档且可引用的版本 DOI 为 10.5281/zenodo.21225551，这是一个概念 DOI，始终指向最新版本。机器可读的元数据位于 CITATION.cff。