imaginode

Imaginode MCP サーバー

node-canvas AI creation studio の imaginode.ai を利用して、ChatGPT、Claude、Claude Code、Cursor、または任意の MCP クライアントから、AI による画像と動画を生成できます。

• 1つのアカウントで89モデルを利用可能：Flux 2、Nano Banana 2、Seedream 5、GPT Image、Kling V3、Seedance 2.5、Veo 3.1、Hailuo、Wan など。モデルごとのページを備えた全カタログは、imaginode.ai/models でご覧いただけます。
• サインインするだけで、キーの貼り付けは不要：このサーバーは OAuth 2.1 に対応しています。ChatGPT、Claude、Claude Code で Imaginode のページを開き、サインインしてアプリを許可します。API キーも引き続き使用できるため、OAuth に対応していないスクリプトやクライアントでも利用できます。
• テンプレートを収録：Imaginode のキャンバスで厳選されたワークフロー（商品撮影、リノベーション、動画エフェクト、児童書、サムネイルなど）をレシピとして利用できます。すぐに実行できるテンプレートへのリンクも付いています。
• 料金が明確：生成結果の前に、各生成の正確な料金がクレジットで返されます（1クレジット＝$0.012、ユーロ建ての請求では€0.01）。失敗した生成は自動的に返金されます。アカウント不要の料金計算ツールで、実行前に料金を確認できます。
• リモートサーバーで、インストール不要：https://imaginode.ai/api/mcp（Streamable HTTP）。

呼び出す前に料金を確認する

API は各生成の正確な料金を返しますが、呼び出しを記述する前に料金を知りたいこともよくあります。アカウントなしで利用できる公開ページが2つあります。

• 料金計算ツール：モデル、長さ、解像度を選び、クレジットとドルで料金を確認できます。
• GET /api/models：同じカタログと料金を、機械で読み取れる JSON 形式で取得できます。認証不要なので、クライアント独自の見積もりを作成できます。

クイックスタート

1. imaginode.ai で無料アカウントを作成します（トライアル用クレジットが含まれます。メールアドレスの認証が必要です）。
2. クライアントを接続します。アシスタントごとの詳しい手順は、imaginode.ai/mcp をご覧ください。

ChatGPT：設定、アプリとコネクター、新規作成の順に進み、https://imaginode.ai/api/mcp を貼り付けて OAuth を選択し、Imaginode アカウントにサインインします。

Claude.ai / Claude Desktop：設定、コネクター、カスタムコネクターを追加の順に進み、https://imaginode.ai/api/mcp を貼り付け、Claude から求められたらサインインします。

Claude Code（初回使用時にブラウザーでサインイン画面が開きます）：

claude mcp add --transport http imaginode https://imaginode.ai/api/mcp

Cursor（.cursor/mcp.json、OAuth）：

{
  "mcpServers": {
    "imaginode": { "url": "https://imaginode.ai/api/mcp" }
  }
}

代わりに API キーを使う場合（スクリプト、OAuth に対応していないクライアント）：プロフィール の API keys セクションでキーを作成し、ヘッダーとして送信します。

claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer imk_YOUR_KEY"

あとは、アシスタントに「霧の立ちこめる森にいる赤いキツネの映画のような画像を生成して」「夕暮れの海の波を5秒間の動画にして」「自分のセルフィーをコレクション用のフィギュアに変える Imaginode テンプレートはどれ？」などと頼むだけです。

ツール

ツール	内容
list_models	画像モデルと動画モデルの一覧です。クレジット単位の料金と、課金対象のオプションを確認できます。
list_templates	厳選されたキャンバステンプレートの一覧です。それぞれの生成内容、使用モデル、1 回あたりのおおよその料金を確認できます。
get_template	テンプレートの完全なレシピ（ノード、モデル、プロンプト、接続、生成例）と、キャンバスで開くリンクを取得します。
generate_image	画像を生成し、結果を待ってから URL を直接返します。デフォルトモデル：Nano Banana 2。
generate_video	動画生成を開始し、request_id と正確な料金を返します。デフォルトモデル：Seedance 2.0。
get_generation_status	生成の状態を確認します（running、出力 URL を含む completed、または自動返金される failed）。

動画の生成には通常 1〜5 分かかります（長時間のジョブでは最大 30 分）。30 秒ごとに get_generation_status を呼び出して状態を確認してください。

OAuth の詳細（クライアント作成者向け）

• ディスカバリー：https://imaginode.ai/.well-known/oauth-authorization-server および https://imaginode.ai/.well-known/oauth-protected-resource。
• PKCE（S256）を使用した認可コードフローと、ローテーションされるリフレッシュトークンに対応しています。動的クライアント登録（RFC 7591）と Client ID Metadata Documents の両方をサポートしています。リダイレクト URI には、https、ループバック http、またはプライベートアプリスキームを使用できます。
• スコープ：generate。認証されていないリクエストには、WWW-Authenticate: Bearer resource_metadata="…" を含む 401 が返されます。
• 接続済みアプリは、ユーザーがプロフィールから、またはクライアントが失効エンドポイント（RFC 7009）を通じて取り消すことができます。

REST API の直接利用

MCP サーバーは、任意のスクリプトからも呼び出せる 3 つの公開エンドポイントを薄くラップしています（Authorization ヘッダーに API キーまたは OAuth アクセストークンを指定します）。

• GET https://imaginode.ai/api/models：モデル一覧と料金を返します。認証は不要です。
• POST https://imaginode.ai/api/generate：リクエスト本文は { "model", "prompt", "duration", "resolution", "aspectRatio", "audio", "imageUrls" }、ヘッダーは Authorization: Bearer imk_… です。{ requestId, cost, balance } を返します。
• GET https://imaginode.ai/api/generate/status?requestId=…：running、outputUrls を含む completed、または返金済みの failed を返します。

入力画像は、Imaginode アカウントでホストされているメディア（メディアライブラリ内のメディア、または以前に生成したメディア）である必要があります。

詳細なドキュメント：imaginode.ai/docs/api-mcp。

制限とセキュリティ

• API キーは個人用の秘密情報です。表示されるのは一度だけで、プロフィールから即時に取り消せます。有効なキーは最大 5 個です。
• 各キーおよび各 OAuth アクセストークンには、1 分あたり 10 回の生成レート制限が適用されます。
• OAuth アクセストークンの有効期間は 1 時間で、サイレントに更新されます。プロフィールの「接続済みアプリ」から、いつでもアプリの接続を解除できます。
• すべての呼び出しで、キャンバスと同じ料金がご自身のアカウントのクレジットから差し引かれます。残高を超えて利用することはできず、失敗した場合は返金されます。

Claude スキル

skills/imaginode フォルダーには、Claude がこのサーバーを適切に使う方法（低価格モデルから始める反復、コストへの配慮、ポーリング間隔）を学ぶための、任意で利用できる Claude Code スキルが含まれています。フォルダーを ~/.claude/skills/imaginode にコピーしてインストールしてください。

ライセンス

MIT。サーバー自体は imaginode.ai で稼働しています。このリポジトリでは、公開マニフェスト、ドキュメント、スキルを公開しています。