Cleanor Tools

Cleanor MCP：画像最適化と開発ユーティリティのための認証不要な MCP サーバー

22 個のツールを備えたホスト型・認証不要の MCP サーバーです。画像の最適化と変換、QR コードの生成、LLM が間違えやすい決定論的な開発ユーティリティの実行ができます。

API キーも登録も OAuth も不要です。Model Context Protocol クライアントから 1 つの URL に接続するだけで、22 個のツールを利用できます。すべて読み取り専用で、自律型エージェントにも安心して使わせられます。

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（画像を 1 枚入力し、最適化後のバイト列を出力）を利用できます。

ツール

22 個のツールすべてに入力と出力のスキーマがあります。そのためクライアントは、テキストの長い羅列ではなく、型付きの 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	実際の OS とファイルシステムのオーバーヘッドを考慮して、ストレージの容量に写真が何枚、または動画が何分収まるかを算出します。形式ごとの内訳を返します。	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 の 16 進ダイジェストを計算します。MD5 は意図的に提供していません。	input（必須）、algorithm（デフォルトは sha-256）
hmac	キー付き HMAC 署名を、16 進数または Base64 で生成します。Webhook の署名と検証に使えます。	message（必須）、secret（必須）、algorithm（デフォルトは sha-256）、encoding（hex | base64）
uuid	UUID v4（ランダム）または v7（時刻順に並べ替え可能で、データベースキーとしてより適しています）。	version（v4 | v7、デフォルトは v4）、count（1～100）
base64	UTF-8 に対応した Base64 のエンコードまたはデコードを行います。URL セーフな文字セットも指定できます。	input（必須）、mode（encode | decode）、url_safe（ブール値）
json_format	JSON を検証した後、整形または圧縮します。キーを再帰的にソートすることもできます。無効な JSON の場合は、正確な解析エラーを返します。	input（必須）、mode（pretty | minify）、sort_keys（ブール値）
jwt_decode	JWT のヘッダーとペイロードをデコードし、有効期限を確認します。署名は検証されず、シークレットも不要です。	token（必須）
regex_test	サンプルテキストに JavaScript 正規表現を適用し、インデックスとキャプチャグループを含むすべての一致（最初の 100 件）を返します。	pattern（必須）、input（必須）、flags（デフォルトは g）
cron_describe	5 フィールドの cron 式を平易な英語で説明し、次の実行時刻を UTC で 5 件表示します。	expression（必須）
unit_convert	長さ、質量、データサイズ、時間、速度、温度の単位を正確に変換します。	value（必須）、from（必須）、to（必須）
datetime	現在の実時刻、または任意のタイムスタンプを、IANA タイムゾーンで ISO 形式、Unix 形式、人間が読みやすい形式に変換します。	input（任意。Unix タイムスタンプまたは ISO 文字列）、timezone（デフォルトは UTC）
url_parse	URL をスキーム、ホスト、ポート、パス、デコード済みクエリパラメーター、フラグメントに分割します。	url（必須）
base_convert	2～36 の基数間で整数を変換します。BigInt で正確に処理するため、大きな値も正確に保たれます。	value（必須）、from_base（デフォルトは 10）、to_base（デフォルトは 16）
diff	2 つのテキストを行単位で比較し、追加行数と削除行数を表示します。各テキストは最大 1000 行です。	a（必須）、b（必須）
color	1 つの色を 16 進数、RGB、HSL に一度に変換します。16 進数、rgb()、hsl()、CSS の色名に対応しています。	value（必須）
color_palette	1 つの基本色から調和のとれたパレットを生成します。	color（必須）、harmony（complementary | analogous | triadic | tetradic | monochromatic）
slugify	タイトルから、URL セーフなスラッグを生成します。小文字化、ハイフン区切り、アクセント記号の除去を行います。	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

ドキュメント

ページ	説明
Claude Code に MCP サーバーを追加する方法	stdio、HTTP、SSE サーバー向けのclaude mcp addコマンド、3つの設定スコープ、接続できないサーバーのデバッグ方法について説明します。
画像最適化用 MCP サーバー	MCP を通じて AI エージェントが画像（WebP、AVIF、JPEG）を圧縮・変換する方法と、形式ごとの実測削減量について説明します。
MCP ツールリファレンス	22個すべてのツールについて、各ツールのセクションに完全な入力・出力スキーマと呼び出し例を記載しています。

FAQ

Cleanor MCP は無料ですか？

はい。アカウントも API キーも有料プランも不要で、無料で利用できます。ホスト型エンドポイントには IP ごとのレート制限（通常は1分あたり120リクエスト、画像最適化では1分あたり30リクエスト）があり、1つのクライアントがほかのクライアントの利用を妨げないようになっています。また、自分で実行したい場合は、ソースを MIT ライセンスのもとで利用できます。

API キーは必要ですか？

いいえ。認証はnoneであることを、GET https://mcp.cleanor.app/v1/capabilitiesで自分で確認できます。登録も OAuth フローも、ローテーションが必要なトークンもありません。クライアントからhttps://mcp.cleanor.app/mcpに接続すれば、すぐにツールを呼び出せます。

どのようなデータが送信されますか？

ツールに渡したデータのみです。22個のツールのうち21個はサーバー上で評価される純粋関数で、optimize_imageは、渡された公開画像 URL も取得します。サーバーにはアカウント、ユーザー識別子、データベース、オブジェクトストアがありません。入力データを永続化するバインディングのない、単一の Cloudflare Worker です。機密データを扱う場合は、stdio ビルドをnpx -y @cleanor/mcpでローカル実行すれば、データがマシンの外に送信されることはありません。

セルフホストできますか？

はい。方法は2つあります。npx -y @cleanor/mcpで stdio を使ってローカル実行できます（同じツールレジストリを使用し、画像エンコードには Cloudflare Images の代わりにsharpを使用します）。または、Worker のエントリーポイントとwrangler.jsoncがどちらもリポジトリに含まれているため、wrangler deployでこのリポジトリを自分の Cloudflare アカウントにデプロイできます。自分で起動する方法を好むレジストリやスキャナー向けには、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 に対応したエージェントフレームワークが該当します。stdio のみに対応するクライアントでは、代わりに npm パッケージを実行できます。どちらの方法でも、src/tools/にある同じツール配列を登録するため、同一の22個のツールを利用できます。

調査データの出典はどこですか？

storage_capacityとimage_format_savingsは、モデルの記憶ではなく、Cleanor Labs が公開している調査の数値を返します。形式ごとの削減量は、24枚の画像からなる Kodak のロスレス画像スイートを使い、SSIM を揃えて実施した統制ベンチマークの結果です。ストレージ容量の数値は、ファイルごとの実測サイズに、実際の OS オーバーヘッドを加えたものです。すべてのレスポンスには、出典ページへのリンクが含まれています：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 エージェントがこれらのツールとデータを利用するためのシンプルな窓口です。

• 無料のブラウザーツール：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 にあります。