Midjourney

主な改善点：

• 自動完了待機：すべての生成ツールで、結果を返す前にタスクの完了を自動的に待機するようになりました
• リアルタイムの進捗更新：画像や動画の作成中に、生成の進捗をリアルタイムで確認できます
• URL マッピングの修正：生成されたコンテンツに確実にアクセスできるよう、画像・動画 URL フィールドのマッピングを修正しました
• レスポンスデータの強化：すべてのツールがステータスと進捗情報を返すようになり、追跡しやすくなりました
• エラー処理の改善：形式を統一した、よりわかりやすいエラーメッセージを表示します

破壊的変更：ありません。すべての変更は後方互換性があります。

手動設定：

MCP の設定を編集します：

{
  "mcpServers": {
    "imaginepro": {
      "command": "npx",
      "args": ["-y", "imaginepro-mcp-server"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

シェルの環境変数を使用：

env ブロックを使わずに設定します：

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

次に、シェルでエクスポートします：

export IMAGINEPRO_API_KEY="sk-your-api-key-here"

注：MCP 設定の env ブロックは、シェルの環境変数より優先されます。

npm を使用してグローバルにインストールします。

npm install -g imaginepro-mcp-server

次に、設定します。

{
  "mcpServers": {
    "imaginepro": {
      "command": "imaginepro-mcp-server",
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

開発またはカスタマイズする場合：

git clone https://github.com/imaginpro/imaginepro-mcp-server.git
cd imaginepro-mcp-server
npm install
npm run build

次に、設定します。

{
  "mcpServers": {
    "imaginepro": {
      "command": "node",
      "args": ["/absolute/path/to/imaginepro-mcp-server/dist/index.js"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

ImaginePro MCP サーバーは、人気のある多くの AI 開発ツールで動作します。各クライアントの具体的な設定手順を以下に示します。

Cursor

Cursor の設定に追加します（.cursor/config.json または設定 UI から）。

{
  "mcpServers": {
    "imaginepro": {
      "command": "npx",
      "args": ["-y", "imaginepro-mcp-server"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Windsurf（Codeium）

{
  "mcpServers": {
    "imaginepro": {
      "command": "npx",
      "args": ["-y", "imaginepro-mcp-server"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Gemini CLI、VS Code、Goose、LM Studio、Warp Terminal、Amp

その他のほとんどの MCP 対応ツールでは、標準の設定を使用します。

{
  "mcpServers": {
    "imaginepro": {
      "command": "npx",
      "args": ["-y", "imaginepro-mcp-server"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

注：ツールによっては、設定キーが若干異なる場合があります（例：VS Code の mcp.servers、Amp の amp.mcpServers）。ご利用のツールの MCP ドキュメントを参照してください。

ImaginePro MCP サーバーは、AI 画像および動画生成用の強力なツールを 8 個提供します。すべてのツールは、生成されたコンテンツへの URL を含む構造化レスポンスを返します。

主要な生成ツール

generate-image

高度なテキストから画像を生成するモデルを使用して、テキストの説明から AI 画像を生成します。

パラメーター：

• prompt（文字列、必須）：生成する画像の詳細な説明
• ref（文字列、任意）：追跡用の参照 ID
• webhookOverride（文字列、任意）：非同期通知用の Webhook URL

戻り値：

• messageId：生成された画像の一意の識別子
• imageUrl：生成された画像への直接 URL
• status：生成ステータス（DONE、FAIL など）
• progress：完了率（0～100）

注：このツールは、画像の生成が完了するまで待機してから結果を返します（通常 30～60 秒）。

使用例：

Generate a photorealistic image of a serene mountain lake at sunrise, with mist rising from the water and pine trees reflected in the still surface

gemini-imagine

テキストプロンプトと既存の画像を組み合わせたマルチモーダル入力を使用して、画像を生成します。

パラメーター：

• contents（配列、必須）：タイプ（'text' または 'image'）、テキスト、URL を含むコンテンツ項目の配列
• model（文字列、任意）：使用するモデル（デフォルト：gemini-2.5-flash-image-preview）
• ref（文字列、任意）：追跡用の参照 ID
• webhookOverride（文字列、任意）：Webhook URL

戻り値：

• messageId：一意の識別子
• imageUrl：生成された画像への直接 URL
• status：生成ステータス
• progress：完了率

注：返却前に自動的に完了まで待機します。

使用例：

Use this image [cat.jpg] and make the cat wearing a royal crown and sitting on a throne

generate-video

2 つのフレーム間を滑らかに遷移する動画アニメーションを作成します。

パラメーター：

• prompt（文字列、必須）：動画の遷移／アニメーションの説明
• startFrameUrl（文字列、必須）：開始フレーム画像の URL
• endFrameUrl（文字列、必須）：終了フレーム画像の URL
• ref（文字列、任意）：参照 ID
• webhookOverride（文字列、任意）：Webhook URL

戻り値：

• messageId：一意の識別子
• videoUrl：生成された動画への直接 URL
• status：生成ステータス
• progress：完了率

注：動画の生成にはより時間がかかります（通常 1～3 分）。このツールは完了まで待機します。

使用例：

Create a smooth morphing video between sunset.jpg and night.jpg with a natural day-to-night transition

画像補正ツール

upscale-image

AI アップスケーリングを使用して、画像の解像度と品質を向上させます。

パラメーター：

• messageId（string、必須）：アップスケールする画像のメッセージ ID
• ref（string、任意）：参照 ID
• webhookOverride（string、任意）：Webhook URL

戻り値：

• messageId：新しいメッセージ識別子
• imageUrl：アップスケールされた画像の URL
• status：生成ステータス
• progress：完了率

**注：**アップスケーリングが完了してから返されます。

使用例：

Upscale the image with message ID abc123 to higher resolution

create-variant

既存の画像から、異なるスタイルやバリエーションの画像を生成します。

パラメーター：

• messageId（string、必須）：ベース画像のメッセージ ID
• ref（string、任意）：参照 ID
• webhookOverride（string、任意）：Webhook URL

戻り値：

• messageId：新しいメッセージ識別子
• imageUrl：バリエーション画像の URL
• status：生成ステータス
• progress：完了率

**注：**バリエーションの生成が完了してから返されます。

使用例：

Create a variant of the image abc123

reroll-image

元のプロンプトをそのまま使用して画像を再生成します。

パラメーター：

• messageId（string、必須）：再生成する画像のメッセージ ID
• ref（string、任意）：参照 ID
• webhookOverride（string、任意）：Webhook URL

戻り値：

• messageId：新しいメッセージ識別子
• imageUrl：新しい画像の URL
• status：生成ステータス
• progress：完了率

**注：**再生成が完了してから返されます。

使用例：

Reroll the image abc123 to get a different result

画像編集ツール

inpaint-image

変更する領域を示すマスクを指定して、画像の特定領域を編集します。

パラメーター：

• messageId（string、必須）：ベース画像のメッセージ ID
• maskUrl（string、必須）：マスク画像の URL（白い領域が編集されます）
• prompt（string、必須）：マスク領域に生成する内容の説明
• ref（string、任意）：参照 ID
• webhookOverride（string、任意）：Webhook URL

戻り値：

• messageId：新しいメッセージ識別子
• imageUrl：インペイント後の画像の URL
• status：生成ステータス
• progress：完了率

**注：**インペインティングが完了してから返されます。

使用例：

Inpaint the image abc123 using mask at mask.png and add a rainbow in the sky

ユーティリティツール

fetch-status

生成タスクのリアルタイムのステータスと進捗状況を確認します。

パラメーター：

• messageId（string、必須）：ステータスを確認するメッセージ ID

戻り値：

• status：現在のステータス（pending、processing、completed、failed）
• progress：進捗率（0～100）
• imageUrl：生成された画像の URL（準備完了時）
• videoUrl：生成された動画の URL（準備完了時）

使用例：

Check the status of generation task abc123

設定ファイル

環境変数の代わりに JSON 設定ファイルを使用できます。

ファイルの場所（次の順に確認されます）：

1. ~/.imaginepro/config.json（グローバル）
2. ./.imaginepro.json（プロジェクト固有）

例（~/.imaginepro/config.json）：

{
  "apiKey": "sk-your-api-key-here",
  "baseUrl": "https://api.imaginepro.ai",
  "timeout": 300000
}

優先順位：環境変数 > 設定ファイル > デフォルト値

カスタムタイムアウトの例

動画の生成や大規模なバッチ処理の場合：

{
  "mcpServers": {
    "imaginepro": {
      "command": "npx",
      "args": ["-y", "imaginepro-mcp-server"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-api-key",
        "IMAGINEPRO_TIMEOUT": "600000"
      }
    }
  }
}

前提条件

• Node.js >= 18.0.0
• npm または yarn
• TypeScript の知識
• テスト用の ImaginePro API キー

セットアップ

git clone https://github.com/imaginpro/imaginepro-mcp-server.git
cd imaginepro-mcp-server
npm install
npm run build

コマンド

Claude Desktop でのテスト

設定をローカルのビルドに向けます。

{
  "mcpServers": {
    "imaginepro-dev": {
      "command": "node",
      "args": ["/absolute/path/to/imaginepro-mcp-server/dist/index.js"],
      "env": {
        "IMAGINEPRO_API_KEY": "sk-your-test-key"
      }
    }
  }
}

よくある問題

「IMAGINEPRO_API_KEY environment variable is required」

原因：サーバーが API キーを見つけられませんでした。

解決方法：

1. MCP の設定で API キーが設定されていることを確認します。

   "env": {
     "IMAGINEPRO_API_KEY": "sk-your-actual-key"
   }
   

2. または、起動前にシェルで環境変数として設定します。

   export IMAGINEPRO_API_KEY="sk-your-api-key"
   

3. 設定を変更した後、MCP クライアント（Claude Desktop など）を再起動します。

「Failed to generate image」または API エラー

考えられる原因と解決方法：

• API キーが無効：imaginepro.ai でキーを確認します
• クレジット不足：アカウント残高を確認します
• ネットワークの問題：インターネット接続とファイアウォールの設定を確認します
• レート制限：少し待ってから、もう一度お試しください
• パラメーターが無効：画像 URL にアクセスできること、およびプロンプトが有効であることを確認します

「Module not found」またはインポートエラー

npm パッケージをインストールする場合：

npm install -g imaginepro-mcp-server

ローカルで開発する場合：

cd imaginepro-mcp-server
npm install
npm run build

サーバーが応答しない

1. サーバーが実際に実行されているか確認します（ログに起動メッセージがあるか確認してください）
2. MCP の設定でコマンドのパスが正しいことを確認します
3. Node.js >= 18.0.0 がインストールされていることを確認します：node --version
4. MCP クライアントのログで詳細なエラーメッセージを確認します

「Command not found: imaginepro-mcp」

グローバルインストールを使用しているときに、バイナリが PATH にない場合に発生します。

解決方法：代わりに npx を使用します。

{
  "command": "npx",
  "args": ["-y", "imaginepro-mcp-server"]
}

「spawn node ENOENT」または「Failed to connect」（nvm を使用した Claude Code）

原因：nvm（Node Version Manager）を使用している場合、Claude Code はシェルの PATH を引き継がないため、node 実行ファイルを見つけられません。

ログのエラー：spawn node /path/to/dist/index.js ENOENT

解決方法：設定で node のフルパスを使用します。

1. node のパスを確認します。

   which node
   # Example output: /Users/username/.nvm/versions/node/v22.19.0/bin/node
   

2. MCP の設定を更新し、フルパスを使用します。

   {
     "mcpServers": {
       "imaginepro": {
         "command": "/Users/username/.nvm/versions/node/v22.19.0/bin/node",
         "args": ["/absolute/path/to/imaginepro-mcp-server/dist/index.js"],
         "env": {
           "IMAGINEPRO_API_KEY": "sk-your-api-key-here"
         }
       }
     }
   }
   

別の方法：npx を使って公開 npm パッケージを使用する場合、npx が node 実行ファイルを自動的に処理するため、この問題は発生しません。

サポートを受ける

問題が解決しない場合：

1. ログを確認する：ほとんどの MCP クライアントでは詳細なログを確認できます
2. 例を確認する：使用例のセクションを参照してください
3. イシューを作成する：GitHub Issues
4. サポートに問い合わせる：ImaginePro Support

バグ報告、機能リクエスト、ドキュメントの改善、コードの提供など、あらゆるコントリビュートを歓迎します。

クイックスタート

1. リポジトリをフォークしてクローンします
2. フィーチャーブランチを作成します：git checkout -b feature/amazing-feature
3. 変更を加えてテストします
4. コミットします：git commit -m 'Add amazing feature'
5. プッシュします：git push origin feature/amazing-feature
6. プルリクエストを作成します

ガイドライン

• TypeScript のベストプラクティスに従ってください
• 明確で説明的なコミットメッセージを使用してください
• 必要に応じてドキュメントを更新してください
• 提出前に Claude Desktop でテストしてください

問題の報告

以下を含めてください：

• 使用環境（OS、Node のバージョン、MCP クライアント）
• 再現手順
• 期待される動作と実際の動作
• エラーメッセージとログ