给 AI Agent 使用

让你的 Agent 用 Sparkles 生图

把 Claude Code、Claude Desktop、Cursor 或其他 MCP 客户端连接到你的 Sparkles 账号。安装开源的 Sparkles Image MCP，登录一次，就能让 Agent 按提示词生成图片和 GIF。

Sparkles Image MCP 是一个本地 MCP 服务，使用你现有的 Sparkles 账号和 Credits；不需要把密码或 API Key 交给 Agent。通过 MCP 生成的图片会和站内创作的图片一样出现在你的作品库中。

一分钟完成安装 GitHub 仓库

一分钟完成安装

选择一种方式即可。Claude Code 插件最快；Claude Desktop、Cursor 或其他 MCP 客户端使用手动配置。

Claude Code 插件

在 Claude Code 中依次运行这两条命令。插件会同时提供 MCP 服务和 sparkles-image 技能。

/plugin marketplace add sparkles-mcp/sparkles-image-mcp
/plugin install sparkles-image@sparkles-image-mcp

手动配置 MCP

把这段配置加入你的 MCP 客户端。支持 stdio MCP 服务的客户端都可以使用。

{
  "mcpServers": {
    "sparkles-image": {
      "command": "npx",
      "args": ["-y", "github:sparkles-mcp/sparkles-image-mcp", "serve"]
    }
  }
}

或使用安装 CLI

CLI 会安装 Agent 技能、打印客户端配置并打开浏览器登录。之后可随时运行 doctor 检查连接。

npx -y github:sparkles-mcp/sparkles-image-mcp init
npx -y github:sparkles-mcp/sparkles-image-mcp doctor

把这段话发给你的 Agent

不确定怎么配置？复制下面的提示发给 Agent，它会添加服务并启动登录。

把这段话发给你的 Agent

为当前客户端配置 Sparkles Image MCP。

服务命令：npx
服务参数：-y github:sparkles-mcp/sparkles-image-mcp serve

如果这是 Claude Code，请运行：
claude mcp add --scope user sparkles-image -- npx -y github:sparkles-mcp/sparkles-image-mcp serve

然后启动 sparkles-image 的 login 工具，等我在浏览器中确认授权。在我明确要求之前不要生成图片；每次生成都会消耗我的 Sparkles Credits。

不要同时安装 Claude Code 插件和同名的手动服务；两者只能选一种。

登录一次，确认授权范围

登录会在浏览器打开 sparkles-editor.com，并等待 127.0.0.1 的本地回调。授权页会显示应用和当前账号。令牌只保存在本机；你随时可以在「账户 → 已连接的 MCP 应用」撤销。访问令牌 15 分钟过期并自动刷新。

images:generate提交和取消生图任务。
images:read读取任务状态、作品库和生成图片。
account:read读取 Credits 余额和用量。

Agent 可以做什么

登录后可以使用这些工具。生图会消耗 Credits，读取类工具不会。

generate_image按提示词生成 1-4 张图片或 1 个 GIF。
get_image查询单个任务，完成后返回图片。
list_images列出最近的图片和任务状态。
check_image_jobs批量查询最多 50 个任务，不下载图片。
cancel_image_jobs取消排队中的任务。
list_image_models列出可用模型、画质和 GIF 支持。
get_credit_balance读取可用 Credits 余额。
get_credit_usage读取最近的扣费和退款记录。
login需要授权时打开浏览器登录。

图片会出现在站内作品库

通过 MCP 生成的图片就是普通的 Sparkles 图片：会出现在「作品库 → 作品」和图片工作台底部的最近作品栏，并沿用网站相同的保存期限——生成完成后 1 天，订阅期间 28 天。想长期保留请选择永久保存。

打开作品库 → 作品

积分与审核

每次生成都会从当前账号扣除 Credits。目录中按用量计费的模型可能显示 0，实际扣费以 get_credit_usage 和账单记录为准。提示词会经过与站内创作相同的审核；被拒绝的提示词会作为错误返回，不要通过改写来规避审核。

常见问题

登录页没有打开: 运行 CLI 的 login 命令；它会打印授权链接，可以手动打开。
login_required 或 login_expired: 重新登录。如果反复出现，在「账户 → 已连接的 MCP 应用」撤销旧授权。
insufficient_credits: 充值或减少请求量。不要让 Agent 盲目重试。
图片还在生成: 让 Agent 用任务 ID 调用 get_image，不要重复提交同一个提示词。
image_too_large: 图片超过 6 MB 的单次返回上限，请在「作品库 → 作品」中查看或下载。
打开的不是正确站点: 如果使用测试站或自建站，请检查 SPARKLES_ISSUER。

一分钟完成安装

Claude Code 插件

手动配置 MCP

或使用安装 CLI

把这段话发给你的 Agent

登录一次，确认授权范围

Agent 可以做什么

图片会出现在站内作品库

积分与审核

常见问题

相关链接