mcpField
M
Modelflare

Modelflare

本地服务
modelflare.dev媒体与设计01 天前更新
代码仓库访问官网

关于 Modelflare

Modelflare 是一个 MCP 服务，可调用 Modelflare 账户可用的模型生成或编辑图像、创建视频。它面向 MCP 客户端用户，使用一个 Smart API Key 配置模型查询与生成工具。

主要功能

  1. 01列出 API 密钥可用模型
  2. 02生成或编辑图像
  3. 03启动异步视频生成
  4. 04查询视频任务状态与进度
  5. 05下载已完成的视频

适用场景

  1. 01查找账户可用的图像或视频模型
  2. 02从 MCP 客户端生成并保存图像
  3. 03提交视频任务并查看进度
  4. 04下载已完成的视频

MCP 相关

向 MCP 客户端提供图像和视频模型查询、生成、状态检查及下载工具。需配置 Modelflare Smart API Key 和输出目录。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "castaly-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@modelflare/mcp-server"
      ],
      "env": {
        "MODELFLARE_API_KEY": "<MODELFLARE_API_KEY>",
        "MODELFLARE_BASE_URL": "<MODELFLARE_BASE_URL>",
        "MODELFLARE_OUTPUT_DIR": "<MODELFLARE_OUTPUT_DIR>"
      }
    }
  }
}
启动命令npx -y @modelflare/mcp-server
需要配置的环境变量
MODELFLARE_API_KEY密钥Modelflare Smart API Key (create one at https://modelflare.dev/keys)
MODELFLARE_BASE_URLglobal (default), china, or a custom base URL
MODELFLARE_OUTPUT_DIRDirectory for generated images and videos (default ./modelflare-output)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@modelflare/mcp-server0.1.2

工具

5

收录的工具列表 · 更新于 6 天前

参数类型必填说明
kindenum否仅列出此类型的模型。image | video | text

详细介绍

Modelflare MCP 服务

为任意 MCP 客户端生成图像和视频——包括 Claude Desktop、Cursor、Gemini CLI 等——只需一个 Modelflare Smart API Key，即可调用你账号可用的所有图像和视频模型。

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

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」，选择路由策略（均衡 / 稳定优先 / 低价优先）。

配置 / 配置

将服务添加到你的 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_URLglobal → https://modelflare.dev/v1（默认值） · china → https://origin.modelflare.dev/v1 · 或自定义 URL
MODELFLARE_OUTPUT_DIR图像和视频的保存位置（默认值为 ./modelflare-output）
MODELFLARE_LOCALEen（默认值）或 zh，用于错误消息

**Claude Desktop：**从 Releases 下载 modelflare-mcp-<version>.mcpb 并打开；Claude Desktop 会询问 API key、基础 URL 和输出文件夹。modelflare-mcp-<version>-smithery.mcpb 是相同的捆绑包，其中包含清单内每个工具的 inputSchema，这是 Smithery 的要求。运行 node build-mcpb.mjs 可重新构建这两个包。

工具 / 工具

工具功能
list_models列出你的 key 可调用的图像和视频模型，每个模型都附有包含其确切请求字段的文档页面。kind: "text" 可列出文本模型。
generate_image生成图像，或使用 edit: true 编辑图像，并保存结果。Gemini 图像模型使用 generateContent；其他模型使用 Images API。
create_video启动异步视频任务并返回其任务 ID。
get_video_status查询视频任务的状态和进度。
download_video保存已完成的视频；可先等待最多 300 秒。

特定模型的字段放在 parameters（图像）或 request（视频）中，并会原样发送。模型列表来自你的 key，因此新增模型会自动显示，无需编辑 key。生成的结果会立即保存，因为结果 URL 会过期。

调用费用按实际用量从你的 Modelflare 余额中扣除；请参阅 https://modelflare.dev/usage-logs。

常见问题 / 常见问题

  • 401：key 缺失或无效。请在 https://modelflare.dev/keys 创建 Smart API Key。
  • model_not_found：普通 key 只能调用所属分组中的模型。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

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。