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 分