Aiimgcombiner Mcp Skill

AI Image Combiner — リモート MCP サーバー＆Claude スキル

複数の写真を組み合わせ、合成し、ブレンドして、AI 生成画像を 1 枚作成します。 無料 API · MCP 対応 · ローカル GPU 不要 · Claude、Cursor、およびあらゆる MCP クライアントで動作

---

AI Image Combiner とは？

AI Image Combiner は、生成 AI を使って2 枚以上の写真を、まとまりのある 1 枚の画像に合成できるクラウドベースの AI 写真編集サービスです。

ウェディング写真のコラージュ、AI カップルアバター、ヘアスタイルのプレビュー、誕生日カードの落書きが必要な場合でも、シンプルな REST API、または AI アシスタント内で MCP（Model Context Protocol）連携を使って利用できます。

このリポジトリには、次のものが含まれています。

アセット	パス	説明
MCP サーバーマニフェスト	mcp/server.json	すぐに使えるリモート MCP 設定
Claude スキル	skill/ai-img-combiner/SKILL.md	すぐにインストールできる Claude Code スキル
cURL の例	examples/curl.sh	実行可能な REST API リファレンス

---

主な機能

• AI による画像合成 — 生成モデルを使って 2 枚以上の写真を 1 枚にまとめます
• スタイルプロンプト — 自然言語で画像のブレンド方法を指定できます
• 標準＆高品質 — タスクごとに処理品質を選択できます
• 非同期ジョブキュー — タスクを送信して結果をポーリングでき、呼び出しがブロックされません
• API キー認証 — ユーザーごとのクレジットシステムを採用し、監査や取り消しが可能です
• リモート MCP — ローカルへのインストールは不要です。HTTPS 経由であらゆる MCP クライアントから利用できます
• ストリーミング可能な HTTP トランスポート — 標準に準拠した MCP 2025 プロトコル

---

クイックスタート — MCP（Claude / Cursor）

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "aiimgcombiner": {
      "url": "https://aiimgcombiner.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

1. aiimgcombiner.com → Settings → API Keys から無料の API キーを取得します
2. 上記の設定を MCP クライアントに貼り付けます
3. 自然言語で指示します：「この 2 枚の写真を組み合わせて、カップルアバターにして」

---

クイックスタート — REST API（curl）

export API_KEY="your_api_key_here"

# 1. Upload image — returns CDN URL
UPLOAD=$(curl -sS -X POST https://aiimgcombiner.com/api/open/v1/upload \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "photo.webp",
    "mimeType": "image/webp",
    "dataBase64": "<BASE64_IMAGE>"
  }')
IMAGE_URL=$(echo "$UPLOAD" | jq -r '.url')

# 2. Submit combine task — returns jobId
TASK=$(curl -sS -X POST https://aiimgcombiner.com/api/open/v1/tasks/image-combine \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"payload\": {
      \"imageUrls\": [\"$IMAGE_URL\", \"https://cdn.example.com/b.webp\"],
      \"stylePrompt\": \"Blend these two portraits into a couple avatar with soft lighting.\",
      \"quality\": \"normal\"
    }
  }")
JOB_ID=$(echo "$TASK" | jq -r '.jobId')

# 3. Poll status until completed
curl -sS "https://aiimgcombiner.com/api/open/v1/tasks/$JOB_ID" \
  -H "Authorization: Bearer $API_KEY"

実行可能な完全な例：examples/curl.sh

---

API リファレンス

エンドポイント

メソッド	エンドポイント	説明
POST	/api/open/v1/upload	Base64 画像をアップロードし、CDN URL を取得します
POST	/api/open/v1/tasks/image-combine	合成ジョブを送信し、jobId を取得します
GET	/api/open/v1/tasks/{taskId}	ジョブのステータスと結果をポーリングします

MCP ツール（MCP クライアントを使用する場合）

ツール	説明
upload_image	画像をアップロードし、url を返します
combine_images	ジョブを送信し、jobId を返します
get_task_status	ジョブをポーリングし、完了時に resultUrl を返します

ステータスコード

コード	意味
401	API キーが無効、または指定されていません
402	クレジットが不足しています
404	タスクが見つからないか、このキーの所有ではありません
500	サーバー側のエラー

---

ツールのページ

aiimgcombiner.com で利用できるすべてのツール：

ツール	URL
2 枚の写真を合成	/combine-two-photos
フォトコラージュメーカー	/photo-collage-maker
ウェディング写真合成	/wedding-photo-combiner
AI カップルアバターメーカー	/ai-couple-avatar-maker
AI ヘアスタイルチェンジャー	/ai-hairstyle-changer
AI 誕生日ドゥードルメーカー	/ai-birthday-doodle-maker

---

料金プラン

プラン	クレジット	機能
無料	登録時にスタータークレジットを付与	すべてのツール、通常品質
Pro（毎月／毎年）	毎月補充	優先キュー、高品質
買い切り	1回限りの購入	今後追加されるすべてのツールを利用可能

→ aiimgcombiner.com/pricing

---

リソース

リソース	URL
公式ドキュメント	aiimgcombiner.com/docs
ブログとチュートリアル	aiimgcombiner.com/blog
変更履歴	aiimgcombiner.com/changelog

---

技術情報

• MCP プロトコル: 2025-12-11、streamable-http トランスポート
• 認証: Authorization: Bearer <API_KEY>
• ベース URL: https://aiimgcombiner.com
• MCP エンドポイント: https://aiimgcombiner.com/api/mcp

---

ベストプラクティス

• キューの待ち時間を短縮するため、アップロード前に画像を 2 MB 以下に圧縮します
• 2～5 秒ごとにポーリングし、短時間に集中したポーリングは避けます
• quality: "high" は最終出力にのみ使用します。「normal」のほうが高速です
• resultUrl は速やかに保存します。CDN リンクは 24 時間後に期限切れになることがあります
• 監査履歴を明確にするため、プロジェクトごとに異なる API Key を使用します

---

リポジトリ構成

aiimgcombiner-mcp-skill/
├── README.md
├── mcp/
│   └── server.json                 # MCP server manifest
├── skill/
│   └── ai-img-combiner/
│       └── SKILL.md                # Claude Code skill definition
└── examples/
    └── curl.sh                     # Runnable curl example

---

aiimgcombiner.com によって提供されています