FitFileSize

FitFileSize MCP サーバー

FitFileSize を使って、AI アシスタントにPDFや画像をアップロード上限、またはフォームの厳密な要件に合わせてもらえます。

「~/Downloads/signature.jpg を IBPS の署名要件に合わせて」

IBPS の署名用に ~/Downloads/signature.fit.jpg を保存しました（JPEG、140 × 60 ピクセル、10 KB～20 KB）：10,240 バイト（10.0 KB）で、上限の20,000バイト以内です。

• 任意の上限：「このスキャンを300 KB未満にして」「この写真を50 KB未満にして」。
• **フォームのプリセット：**米国ビザ用写真（DS-160）、インドの電子ビザ用パスポートページおよび写真、IBPS、SBI、RRB、SSC、NEET、JEE Main、CUET、GATE のアップロード、IRCC 書類、Discord の絵文字、プロフィールバナー、メッセージのアップロードに対応しています。プリセットによって、サイズ上限、最小サイズ、厳密なピクセル数が設定されます。すべて確認するには list_forms を指定してください。
• 複数ファイルを一度に：「この5つの書類をそれぞれ2 MB未満にして」。
• 上限が許す範囲で画質をできるだけ保ち、結果を元のファイルと同じ場所に <name>.fit.<ext> として保存します。JPEGでよいと指定しない限り、すべてのファイルで形式を維持します（PNGはPNGのままです）。iPhone の HEIC 写真はJPEGで返されます。
• 無料で、アカウントもAPIキーも不要です。最大50 MBのファイルに対応しています。

セットアップ

Node.js 20.10 以降が必要です。コピー用ボタン付きの手順はこちらです：fitfilesize.com/claude.html。

Claude Code

claude mcp add fitfilesize -- npx -y fitfilesize-mcp

mcpServers 設定ファイルを使用する Claude Desktop、Cursor、Windsurf、その他のクライアント：

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

（Claude Desktop：Settings → Developer → Edit Config。Cursor：~/.cursor/mcp.json。）

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "fitfilesize": { "command": "npx", "args": ["-y", "fitfilesize-mcp"] }
  }
}

ツール

fit_file

引数
path	ファイルのフルパス（~/ を使用できます）。PDF、JPEG、PNG、WebP、TIFF、BMP、またはHEIC（JPEGで返されます）。最大50 MB。
paths	path の代わりに指定します。同じ上限を適用するファイルを最大10個指定できます。それぞれ元のファイルと同じ場所に保存されます。失敗したファイルがあっても、残りの処理は続行され、失敗したファイルが報告されます。
limit	「"200KB"」や「"1.5MB"」のようなアップロード上限。KBとMBは1000を基準とするため、どちらの方式でチェックされても結果は上限を満たします。
form	limit の代わりに指定します。list_forms にある「"ibps-photo"」のようなフォームのプリセット。
width、height	省略可能な正確なピクセルサイズ。画像のみ。
fit	ピクセルサイズの変更で縦横比が変わる場合の処理。「"crop"」（デフォルト）または白で「"pad"」。
minimum	省略可能な最小サイズ。「"10KB"」のように指定します。小さなJPEGは画像を変更せずに、このサイズまでパディングされます。
jpeg_ok	省略可能です。true にすると、PNG、WebP、TIFF、BMPで、JPEGにすることで条件を満たせる場合はJPEGで返します。デフォルトでは無効です。有効にすると役立つ場合は、結果にその旨が表示されます。
output	省略可能な結果の保存先パス。path のみを指定した場合に使用できます。

list_forms

各フォームのルールと、その情報の出典となる公式ソースを含むフォームのプリセット一覧です。一覧は fitfilesize.com/forms.json から読み込まれるため、更新しなくても新しいフォームが表示されます。サイトに接続できない場合に備えて、コピーも同梱されています。

プライバシー

ファイルはHTTPS経由で FitFileSize のサーバーに送信され、そこで圧縮された後、結果がお使いのコンピューターに保存されるとすぐに削除されます。リクエストに含まれるのはパッケージ名とそのバージョン（fitfilesize-mcp/0.2.1）のみで、ユーザーに関する情報は含まれません。それ以外の情報が端末の外に送信されることはありません。プライバシーページをご覧ください。アップロードは、サイトの無料利用枠である1時間あたり30件にカウントされます。

開発

npm install
npm test          # the tools through an MCP client, against a stand-in API
npm run build     # bundles the form presets from the website's data

FITFILESIZE_API を指定すると、サーバーの接続先APIを変更できます。ローカルAPI（http://127.0.0.1:8000）などを指定します。

ライセンス

MIT。詳細は LICENSE をご覧ください。このライセンスはこのフォルダー内のMCP サーバーに適用されます。FitFileSize リポジトリのその他の部分はオープンソースではありません。