spronta

@spronta/mcp

AI アシスタントから直接、グローバル CDN 上で画像をアップロード、変換、配信するための MCP サーバーです。

Claude、GPT、Cursor、Windsurf、または MCP 対応クライアントを Spronta Image CDN に接続できます。URL または base64 から画像をアップロードし、リアルタイム変換（サイズ変更、トリミング、形式変換、スマートトリミング、blurhash）、再利用可能なプリセットの作成、署名付き URL の生成、使用状況の監視を、すべて自然言語で行えます。

これを使う理由

• AI から画像をアップロード — LLM に画像 URL を渡すと、画像をアップロードして最適化し、CDN リンクを返します
• リアルタイム変換 — サイズ変更、トリミング、WebP/AVIF/JXL への変換、顔検出によるスマートトリミング
• グローバル CDN 配信 — 世界各地のエッジロケーションから画像を配信します
• Blurhash の生成 — アップロード時にぼかしプレースホルダーを自動計算します
• 署名付き URL — 非公開画像用に、有効期限付きの HMAC-SHA256 署名付き URL を生成します
• 名前付きプリセット — 再利用可能な変換設定を作成します（例：thumbnail、hero、og-image）
• ベンダーロックインなし — MIT ライセンスのオープンソースです

クイックスタート

インストール

npm install -g @spronta/mcp
# or use directly
npx @spronta/mcp

Claude Code

claude mcp add spronta \
  -e SPRONTA_API_KEY=spronta_img_... \
  -e SPRONTA_PROJECT_ID=your-project-id \
  -- npx @spronta/mcp

Claude Desktop / Cursor / Windsurf

MCP 設定ファイルに追加します：

{
  "mcpServers": {
    "spronta": {
      "command": "npx",
      "args": ["@spronta/mcp"],
      "env": {
        "SPRONTA_API_KEY": "spronta_img_...",
        "SPRONTA_PROJECT_ID": "your-project-id"
      }
    }
  }
}

API キーを取得する

1. app.spronta.com で登録します（無料プラン：画像 100 枚）
2. ダッシュボードでプロジェクトを作成します
3. プロジェクト設定から API キーをコピーします

環境変数

変数	必須	説明
SPRONTA_API_KEY	はい	プロジェクトの API キー
SPRONTA_PROJECT_ID	いいえ	デフォルトのプロジェクト ID（ツールごとに渡すこともできます）
SPRONTA_API_URL	いいえ	API のベース URL（デフォルト：https://app.spronta.com/api）

18 個のツールを利用可能

プロジェクト

ツール	説明
list_projects	すべての画像プロジェクトを一覧表示します
create_project	新しいプロジェクトを作成します
get_project	使用状況の統計情報とともにプロジェクトの詳細を取得します
update_project	名前またはカスタムドメインを更新します
delete_project	プロジェクトを完全に削除します

アップロードと画像

ツール	説明
upload_image	URL または base64 からアップロードします。署名付きアップロード、blurhash の生成、CDN URL の作成を 1 回の呼び出しで処理します
list_images	ページネーション付きで画像を一覧表示します
update_image	alt テキストとタグを更新します
delete_image	CDN とストレージから画像を削除します

変換プリセット

ツール	説明
list_presets	名前付きの変換プリセットを一覧表示します
create_preset	プリセットを作成します（CDN URL で ?t=name を指定して使用します）
update_preset	プリセット名または変換設定を更新します
delete_preset	プリセットを削除します

URL 署名

ツール	説明
get_signing_config	URL 署名設定を取得します
update_signing	HMAC-SHA256 署名を有効または無効にします
generate_signed_url	有効期限を指定して、または指定せずに署名付き CDN URL を生成します

分析とユーティリティ

ツール	説明
get_usage	日次メトリクス（リクエスト数、帯域幅、変換数）を取得します
build_cdn_url	変換パラメーターを指定した CDN URL を構築します（API 呼び出しなし）

プロンプトの例

接続したら、AI にそのまま尋ねるだけです：

> Upload this image to my project: https://example.com/photo.jpg

> Create a thumbnail preset: 200x200, cover crop, face detection, webp format

> How many requests did my project handle this week?

> Generate a signed URL for hero.jpg that expires in 1 hour

> List all my images and update the alt text on the product shots

> Build a CDN URL for banner.png at 1200px wide in avif format

変換オプション

プリセットの作成や URL の構築時に、次の変換を利用できます。

パラメーター	型	説明
width	integer	出力幅（1～8192）
height	integer	出力高さ（1～8192）
fit	string	cover、contain、fill、scale-down、crop、pad
format	string	auto、webp、avif、jpeg、png、jxl
quality	integer	1～100
qualityMode	string	high、medium、low（知覚品質に基づく最適化）
gravity	string	auto、face、center、位置を示すキーワード
blur	integer	ガウスぼかし（1～250）
sharpen	number	アンシャープマスク（0～10）
radius	integer	角の半径（1～9999、円形にする場合は「max」）
grayscale	boolean	グレースケールに変換
brightness	integer	-100～100
contrast	number	-100～100
saturation	integer	-100～100
sepia	boolean	セピア調フィルター
rotate	integer	90、180、270
flip	string	h（水平方向）、v（垂直方向）

アップロードの仕組み

upload_image ツールは、1 回の呼び出しでアップロード処理全体を実行します。

1. 画像の URL（または Base64 データ）とファイル名を指定します
2. サーバーが画像を取得します
3. Spronta に署名付きアップロード URL をリクエストします
4. ファイルをストレージに直接アップロードします
5. アップロードを確定します。Spronta が blurhash を計算し、寸法を検出します
6. CDN URL、blurhash、メタデータが含まれる、確定済みの画像を返します

関連パッケージ

• @spronta/images — コア URL ビルダー SDK（依存関係ゼロ）
• @spronta/images-react — React コンポーネント
• @spronta/images-next — Next.js 連携
• WordPress プラグイン — WordPress 用自動 CDN

リンク

• ウェブサイト
• ドキュメント
• API リファレンス
• OpenAPI 仕様
• GitHub
• npm

ライセンス

MIT