Modelflare

io.github.castaly-ai由 GitHub 帳號 castaly-ai 發布v0.1.2更新於 Oct 29, 2026

Image and video generation with one Modelflare Smart API Key.

已驗證STDIO僅桌面媒體與設計AI 與機器學習

概覽

AI 產生的概覽

Modelflare MCP 伺服器讓助理透過一組 Modelflare Smart API Key 列出、生成與編輯圖片並建立影片，結果儲存在本機。

可以做什麼
  • 列出此 API Key 可呼叫的圖片、影片與文字模型，並附上各模型的請求說明
  • 以指定圖片模型生成圖片，或用 edit 編輯既有圖片並儲存結果
  • 啟動非同步影片任務並回傳任務 ID
  • 查詢影片任務的狀態與進度
  • 將完成的影片下載到輸出目錄，可選擇先等待任務完成
適用情境
適合想在 Claude Desktop、Cursor、Gemini CLI 等 MCP 用戶端中直接用提示詞產生圖片或影片、不必切換工具的情況，前提是已有或願意註冊 Modelflare 帳號並儲值餘額。
執行需求
以 stdio 在本機執行，通常透過 npx 使用 npm 套件。需要 MODELFLARE_API_KEY 中的 Modelflare Smart API Key。可選用 MODELFLARE_BASE_URL（global、china 或自訂）、MODELFLARE_OUTPUT_DIR 指定媒體儲存目錄、MODELFLARE_LOCALE 設定錯誤訊息語言。需要連線至 Modelflare 的網路與帳號餘額。
安裝前請注意
每次生成都會依實際用量從 Modelflare 餘額扣款，提示詞可能產生費用，請留意用量紀錄與餘額。API Key 屬機密，透過環境變數傳入。生成檔案會寫入輸出目錄，且結果連結會過期，應在完成後盡快下載。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Modelflare，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Modelflare MCP Server

Image and video generation for any MCP client — Claude Desktop, Cursor, Gemini CLI and more — with one Modelflare Smart API Key for every image and video model available to your account.

用一个 Modelflare Smart API Key，在任意 MCP 客户端里调用你账号可用的全部图像和视频模型。

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

Get a Smart API Key / 获取 Smart API Key

  1. Sign up / 注册: https://modelflare.dev/sign-up?utm_source=mcp-registry&utm_medium=plugin&utm_campaign=integrations

  2. Console → API Keys → Create Smart API Key, and pick a routing strategy (Balanced / Stability first / Low price first).

    控制台 API Keys →「Create Smart API Key」，选择路由策略（均衡 / 稳定优先 / 低价优先）。

Configure / 配置

Add the server to your MCP client:

json
{  "mcpServers": {    "modelflare": {      "command": "npx",      "args": ["-y", "@modelflare/mcp-server"],      "env": {        "MODELFLARE_API_KEY": "<your Smart API Key>"      }    }  }}
VariableValue
MODELFLARE_API_KEYyour Smart API Key (required)
MODELFLARE_BASE_URLglobal → https://modelflare.dev/v1 (default) · china → https://origin.modelflare.dev/v1 · or a custom URL
MODELFLARE_OUTPUT_DIRwhere images and videos are saved (default ./modelflare-output)
MODELFLARE_LOCALEen (default) or zh for error messages

Claude Desktop: download modelflare-mcp-<version>.mcpb from Releases and open it; Claude Desktop asks for the API key, base URL and output folder. modelflare-mcp-<version>-smithery.mcpb is the same bundle with each tool's inputSchema in the manifest, as Smithery requires. node build-mcpb.mjs rebuilds both.

Tools / 工具

ToolWhat it does
list_modelsImage and video models your key can call, each with the docs page holding its exact request fields. kind: "text" lists text models.
generate_imageGenerates an image, or edits one with edit: true, and saves it. Gemini image models use generateContent; the others use the Images API.
create_videoStarts an asynchronous video task and returns its task ID.
get_video_statusStatus and progress of a video task.
download_videoSaves a finished video; can wait up to 300 seconds first.

Model-specific fields go in parameters (images) or request (videos) and are sent unchanged. The model list comes from your key, so new models appear without editing the key. Generated results are saved right away because result URLs expire.

Calls are billed to your Modelflare balance by actual usage; see https://modelflare.dev/usage-logs.

Troubleshooting / 常见问题

  • 401: the key is missing or invalid. Create a Smart API Key at https://modelflare.dev/keys.
  • model_not_found: a regular key only calls the models of its own group. A Smart API Key calls every model available to your account. If you already use a Smart API Key, that model is not available to your account right now.
  • 403 insufficient_user_quota: top up at https://modelflare.dev/billing.

Links

Docs: https://docs.modelflare.dev/ · Pricing: https://modelflare.dev/pricing

Listed on the M8ven MCP Trust Index.

License

MIT © Havenbyte LLC

來源：README.md，提交 c99ab6e

工具

5

list_models

List Modelflare models

Lists the models this Modelflare API key can call, with the docs page that holds each media model's exact request contract. Defaults to image and video models.

輸入參數kind

generate_image

Generate or edit an image

Generates an image, or edits one with edit=true, using a Modelflare image model, and saves the result to the output directory. Billed to the Modelflare balance by actual usage.

輸入參數editmodel必填prompt必填parameters

create_video

Create a video task

Starts an asynchronous Modelflare video task and returns its task ID. Poll with get_video_status and save with download_video. Billed to the Modelflare balance by actual usage.

輸入參數model必填request必填

get_video_status

Get video task status

Returns the status and progress of a Modelflare video task.

輸入參數task_id必填

download_video

Download a finished video

Saves a completed Modelflare video to the output directory. Optionally waits for the task first. Result URLs expire, so download soon after completion.

輸入參數task_id必填wait_seconds

版本歷史

2
  1. v0.1.2最新Oct 23, 2026
  2. v0.1.1Oct 14, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分