SuperAPI AI 工具集

cleanor-mcp

Cleanor MCP 是一个面向 AI 代理的零认证 MCP(Model Context Protocol)服务器,由 Cleanor Labs 开发,托管于 mcp.cleanor.app。它将图像处理与确定性开发工具封装为 22 个工具,供任何支持 Streamable HTTP 的 MCP 客户端直接调用,无需 API 密钥、注册或 OAuth。主要能力包括:图像优化与格式转换(WebP、AVIF、JPEG)、生成 QR 码、返回有出处的存储容量与图像格式节省数据,以及哈希、进制运算、时区、计数等 18 项开发工具。官方说明 22 个工具中 21 个为纯函数、只读(readOnlyHint: true),仅 optimize_image 会访问网络(openWorldHint: true);托管端点按 IP 限速(常规每分钟 120 次,图像优化每分钟 30 次)。项目免费使用,源码以 MIT 许可发布,可本地通过 npx 以 stdio 方式运行,或部署到自己的 Cloudflare 账户。

访问官网

工具介绍

用途

Cleanor MCP 是 Cleanor Labs 提供的 MCP 服务器,用于把图像优化与一系列确定性开发工具接入 AI 代理。官方描述其为一个零认证的托管 MCP 服务器,提供 22 个工具,主要解决两件事:图像优化与格式转换,以及 LLM 容易出错的确定性计算类工具。使用者只需把 MCP 客户端指向一个 URL,即出现 22 个工具,全部为只读,可交给自主代理使用。

主要能力

官方列出的工具分为三类:

  • 图像(image):optimize_image,优化并转换图像格式(WebP/AVIF/JPEG)。
  • 数据(data):包括 storage_capacity 和 image_format_savings,返回来自 Cleanor Labs 已发表研究的数字,而非模型记忆。官方说明格式节省数据来自在 24 张 Kodak 无损测试集上、在匹配 SSIM 条件下的受控基准;存储数字来自实测的单件文件大小加上真实操作系统开销。每个响应都链接到 cleanor.app/research 上的来源页面。
  • 开发(dev):18 项开发工具,官方描述为 LLM 不擅长的操作,如哈希、计数、进制运算、时区。属于纯计算,无网络、无状态。

所有工具都带有输入和输出 schema,客户端可获得带类型的结构化内容(structuredContent),而不仅是一段文本。官方说明除 optimize_image 外,其余 21 个工具都是其输入的纯函数。项目还提供 data/tools.csv,以扁平、机器可读的表格列出这 22 个工具的名称、标题、类别(image、data、dev)、摘要、必需和可选参数以及输出字段;该文件由 src/tools/ 中每个工具的 Zod schema 生成。

使用方式

官方说明托管端点无需构建、安装或密钥。支持多种客户端:

  • Claude Code:添加后运行 claude mcp list 确认连接;完整步骤见 docs/add-an-mcp-server-to-claude-code.md。
  • Cursor:在 .cursor/mcp.json(按项目)或 ~/.cursor/mcp.json(全局)中添加配置。
  • VS Code:运行 code --add-mcp '{"name":"cleanor","type":"http","url":"https://mcp.cleanor.app/mcp"}',或在工作区的 .vscode/mcp.json 中添加服务器。
  • Claude Desktop:打开 Settings,进入 Connectors,选择 “Add custom connector”,粘贴端点。
  • 本地 stdio:可通过 claude_desktop_config.json 运行本地 stdio 服务器;也可使用 npx -y @cleanor/mcp。官方说明 npm 构建是同一工具注册表编译为 Node,使用 sharp(可选依赖)进行本地图像编码,其余 21 个工具无需依赖。

端点使用 MCP Streamable HTTP 传输,可用 curl 或任意 HTTP 客户端驱动。另有面向非 MCP 调用方的普通 REST 接口:GET /v1/capabilities(功能检测、机器可读的工具列表)和 POST /v1/optimize(输入一张图像,输出优化后的字节)。

适用场景

官方定位是供 AI 代理调用,适合需要图像优化/格式转换、QR 码生成、需要引用出处的存储与格式数据,以及需要可靠的哈希、UUID、JWT 解码、正则等开发工具的场景(官方描述中提及 hashes、UUIDs、JWT decoding 和 regex)。任何支持 Streamable HTTP 的 MCP 客户端均可使用,如 Claude Code、Claude Desktop(自定义连接器)、Cursor、VS Code 以及支持 MCP 的代理框架;仅支持 stdio 的客户端可改用 npm 包。两种方式暴露相同的 22 个工具。

限制与说明

  • 免费使用,无账户、无 API 密钥、无付费层级。托管端点按 IP 限速:常规每分钟 120 次请求,图像优化每分钟 30 次。
  • 认证方式为 none,可在 GET https://mcp.cleanor.app/v1/capabilities 自行验证;无注册、无 OAuth、无 token 轮换。
  • 数据方面:仅发送你传给工具的内容。22 个工具中 21 个是在服务器上求值的纯函数;optimize_image 还会获取你提供的公开图像 URL。官方称服务器无账户、无用户标识、无数据库或对象存储,是一个没有持久化绑定的单个 Cloudflare Worker。若数据敏感,可用 npx -y @cleanor/mcp 在本地运行 stdio 构建,数据不离开本机。
  • 自托管有两种方式:用 npx -y @cleanor/mcp 在本地以 stdio 运行(同一工具注册表,由 sharp 负责图像编码而非 Cloudflare Images),或把仓库部署到自己的 Cloudflare 账户(wrangler deploy),Worker 入口和 wrangler.jsonc 均在仓库中。Dockerfile 为偏好自行启动的注册表与扫描器构建 stdio 服务器。
  • 托管(Streamable HTTP)与本地(stdio)的区别:本地服务器由客户端在本机生成进程,可访问文件系统,但需要安装、更新并携带依赖;托管服务器只是一个 URL,无需安装、无版本漂移,重活在他人 CPU 上运行。官方建议图像优化优先用托管端点,因为由 Cloudflare Images 做编码,无需安装 sharp。
  • 引用要求:使用 Cleanor MCP 或其数据时请引用。作者为 Cleanor Labs,ORCID 0009-0005-4623-961X。归档可引用版本的 DOI 为 10.5281/zenodo.21225551,这是一个始终解析到最新版本的 concept DOI。机器可读元数据位于 CITATION.cff。
  • 许可:MIT,Cleanor Labs。

本条目未提供的信息(如具体性能指标、其他平台支持细节等)暂未提供。