Modelflare

Modelflare MCP Server

すべての MCP クライアント（Claude Desktop、Cursor、Gemini CLI など）で画像や動画を生成できます。アカウントで利用可能なすべての画像・動画モデルに、1 つの Modelflare Smart API Key でアクセスできます。

mcp-name: io.github.castaly-ai/mcp-server

Smart API Key を取得する / Smart API Key の取得

1. サインアップ: https://modelflare.dev/sign-up?utm_source=mcp-registry&utm_medium=plugin&utm_campaign=integrations

2. コンソールで「API Keys」→ Create Smart API Key を選択し、ルーティング戦略（均衡 / 安定性優先 / 低価格優先）を選びます。

   コンソールで「API Keys」→「Create Smart API Key」を選択し、ルーティング戦略（均衡 / 安定性優先 / 低価格優先）を選びます。

設定 / Configure

MCP クライアントにサーバーを追加します。

{
  "mcpServers": {
    "modelflare": {
      "command": "npx",
      "args": ["-y", "@modelflare/mcp-server"],
      "env": {
        "MODELFLARE_API_KEY": "<your Smart API Key>"
      }
    }
  }
}

変数	値
MODELFLARE_API_KEY	お使いの Smart API Key（必須）
MODELFLARE_BASE_URL	global → https://modelflare.dev/v1（デフォルト） · china → https://origin.modelflare.dev/v1 · またはカスタム URL
MODELFLARE_OUTPUT_DIR	画像と動画の保存先（デフォルトは ./modelflare-output）
MODELFLARE_LOCALE	エラーメッセージの言語。en（デフォルト）または zh

Claude Desktop: Releases から modelflare-mcp-<version>.mcpb をダウンロードして開くと、Claude Desktop が API キー、ベース URL、出力フォルダーを尋ねます。modelflare-mcp-<version>-smithery.mcpb は、Smithery の要件に従い、各ツールの inputSchema をマニフェストに含めた同じバンドルです。node build-mcpb.mjs で両方を再ビルドできます。

ツール / Tools

ツール	機能
list_models	キーで呼び出せる画像・動画モデルの一覧です。それぞれの正確なリクエストフィールドが記載されたドキュメントページも確認できます。kind: "text" を指定するとテキストモデルを一覧表示します。
generate_image	画像を生成するか、edit: true を指定して画像を編集し、保存します。Gemini の画像モデルでは generateContent を使用し、それ以外では Images API を使用します。
create_video	非同期の動画タスクを開始し、タスク ID を返します。
get_video_status	動画タスクのステータスと進行状況を確認します。
download_video	完成した動画を保存します。事前に最大 300 秒間待機できます。

モデル固有のフィールドは parameters（画像）または request（動画）に指定すると、変更されずに送信されます。モデル一覧はキーから取得されるため、キーを編集しなくても新しいモデルが表示されます。結果 URL は有効期限が切れるため、生成結果はすぐに保存されます。

呼び出し料金は実際の使用量に応じて Modelflare の残高から差し引かれます。https://modelflare.dev/usage-logs をご覧ください。

トラブルシューティング / Troubleshooting

• 401: キーがないか、無効です。https://modelflare.dev/keys で Smart API Key を作成してください。
• model_not_found: 通常のキーで呼び出せるのは、そのキーと同じグループのモデルのみです。Smart API Key では、アカウントで利用可能なすべてのモデルを呼び出せます。すでに Smart API Key を使用している場合、そのモデルは現在アカウントで利用できません。
• 403 insufficient_user_quota: https://modelflare.dev/billing でチャージしてください。

リンク

ドキュメント: https://docs.modelflare.dev/ · 料金: https://modelflare.dev/pricing

ライセンス

MIT © Havenbyte LLC