optiq-mcp

optiq-mcp

AI エージェントがプロジェクト内の画像をOptiqで最適化できるMCPサーバーです。stdio 経由でローカル実行され、データがアップロードされることはありません。

claude mcp add optiq -- npx -y optiq-mcp          # Claude Code

{ "mcpServers": { "optiq": { "command": "npx", "args": ["-y", "optiq-mcp"] } } }

JSON 形式は Claude Desktop、Cursor、その他のクライアント向けです。VS Code（.vscode/mcp.json）では、 { "servers": { "optiq": { "type": "stdio", "command": "npx", "args": ["-y", "optiq-mcp"] } } }を使用してください。

ツール

ツール	書き込み	機能
analyze_images	いいえ（readOnlyHint）	ドライランです。各画像について、選択された形式、変換前後のバイト数、測定された品質（SSIM またはピクセル単位で完全一致）を報告します
optimize_images	はい	write: "in-place"では形式とファイル名を維持するため、コード内の参照は有効なままです。write: "out-dir"では形式が変わる場合があります

各モードで保証される内容：

• lossless：ピクセルが同一であることを検証します；
• visually-lossless：SSIM ≥ 0.99；
• balanced（デフォルト）：SSIM ≥ 0.975；
• fast：balancedと同じしきい値ですが、AVIF は使用せず、エンコード回数も少なくなります。

結果が検証に合格し、ファイルサイズが小さくなった場合にのみファイルが置き換えられます。非可逆圧縮の出力には約 20 バイトのマーカーが付与されるため、optimize_imagesを再度実行しても再エンコードされず、劣化が重なることもありません（reoptimize: trueを指定すると、この動作は上書きされます）。

その他のオプション：

• mode；
• keepFormat；
• formats；
• maxSize（長辺を縮小します）；
• stripMetadata（GPS を含む EXIF と XMP を削除します）；
• minQuality；
• minSaving。

ドキュメント全文：https://baukaalm.github.io/optiq/guide/agents

Node ≥ 20 が必要です。Apache-2.0。コーデックのライセンスについては、 optiq-image NOTICEに記載されています。