recraft-mcp-server

🎨 Recraft MCP Server

一个 Model Context Protocol (MCP) 服务，可让 AI 助手 （Claude、Gemini 或任何 MCP 客户端）直接访问 Recraft AI 图像 生成 API，无需离开聊天即可生成、转换、放大和矢量化图像。

“生成一组 8 个具有相同艺术风格的奇幻游戏图标。” “移除此截图的背景并将其放大。” “为这个徽标创建 5 种风格变体，并将它们放入对比网格中。”

从官方服务迁移而来？

Recraft 于 2026 年 7 月归档了 @recraft-ai/mcp-recraft-server，现在将 用户引导至托管端点 https://mcp.recraft.ai/mcp。三种方案中该选择哪一种，取决于你的 使用场景：

	Recraft 托管服务	此服务
设置	在浏览器中进行 OAuth，无需 API 密钥	npm install + API 密钥
工具	9	28
计费	订阅额度	API 单位用量，每个工具都会报告调用成本
本地文件	否 — 仅支持 URL 和 base64	读取和写入你机器上的文件
批处理 / 流水线	否	生成 → 下载 → 移除背景 → 保存、主题套图、对比网格
风格管理	仅创建	创建、列出、检查、删除

如果你只是偶尔生成图像，托管服务更省事，而此服务对你没有额外帮助。如果你要批量 制作素材、处理磁盘上的文件，或需要在运行前了解任务的成本，那么此服务正是为此而设。

工具名称对应关系

除特别注明外，这里的名称是在旧名称前加上 recraft_ 前缀：

官方名称（已归档）	此处名称
generate_image	recraft_generate_image
image_to_image	recraft_image_to_image
remove_background	recraft_remove_background
replace_background	recraft_replace_background
crisp_upscale	recraft_crisp_upscale
creative_upscale	recraft_creative_upscale
create_style	recraft_create_style
vectorize_image	recraft_vectorize
get_user	recraft_check_credits

有一项值得了解的行为差异：Recraft 的 style 字段接受六种大类，而具体风格 （pixel_art、kawaii、b_and_w……）则通过单独的 substyle 字段指定。将子风格名称 作为 style 传入时，API 会静默忽略。本服务可以接受其中任意一种并正确处理，因此 针对旧服务编写的提示词仍可正常使用。

🌟 主要功能

• 🖼️ 文生图 — 支持所有 Recraft 模型（V4.1、V4 Styles、V4、V4 Vector/SVG、V4 Pro、V3、V2），涵盖完整的风格分类体系——6 大类 × 104 种子风格，直接根据 Recraft 自身的 API 规范生成，而非手动转录
• 🔁 图像转换 — 图生图、局部重绘、替换 / 生成背景、扩图（画布扩展）、生成变体
• ✨ 图像增强 — 移除背景、矢量化、清晰 / 创意放大、擦除区域
• 🔎 探索 — 开放式探索生成、“生成更多类似图像”以及自动优化提示词
• 🧩 素材工作流 — 一次调用即可完成生成 → 下载 → 移除背景 → 保存；还支持批量生成、保持风格一致的主题素材集
• 🎮 游戏开发扩展功能 — 按指定尺寸生成精灵图 / 图标、风格对比网格、纹理 / 图集替换
• 👁️ Agent 可以查看生成的图像 — 生成结果会附带行内预览和 URL，并缩小至适合上下文预算的尺寸。没有此功能，模型生成四个变体后却无法判断其中任何一个的效果
• 💰 每次调用都会报告价格 — Recraft 会说明每项操作的积分成本，本工具也会传递此信息，让 Agent 在批量运行前就能判断 4 积分的清晰放大和 250 积分的创意放大有何不同
• 🎨 风格管理 — 创建自定义风格，然后列出、查看和删除风格

🛠️ 提供的工具

此 MCP 服务向 AI Agent 提供 28 种工具，全面覆盖 Recraft API。

生成

工具	描述
recraft_generate_image	使用所有 Recraft 模型进行文生图，支持 70 多种风格以及颜色 / 文本布局控制
recraft_generate_sized	按任意目标尺寸生成图像（最低 64×64）——适用于精灵图 / 图标 / UI
recraft_batch_generate	按顺序生成多个素材，并运行完整工作流；可应对单个素材生成失败的情况
recraft_generate_themed_set	生成一个主视觉素材、匹配的风格以及其余所有符号，并保持视觉一致性
recraft_compare_styles	使用多种风格生成相同提示词的图像，并可选择生成并排对比网格

探索

工具	描述
recraft_explore	生成一组多样化图像，以开放式探索提示词
recraft_explore_similar	根据之前 recraft_explore 的结果，生成更多视觉上相似的图像
recraft_enhance_prompt	将简短提示词扩展为更丰富、更详细的提示词

转换

工具	描述
recraft_image_to_image	根据文本提示词转换现有图像（可调整强度）
recraft_inpaint	重新生成图像中经过遮罩的区域
recraft_replace_background	使用 AI 生成新背景，同时保留主体
recraft_generate_background	填充现有画布中经过遮罩的背景区域
recraft_outpaint	在图像原始边界之外扩展画布，并生成 AI 内容
recraft_variate_image	为现有图像生成变体
recraft_texture_swap	用新的 AI 内容替换指定区域，专为 Spine 图集 / 精灵图表替换设计

增强

工具	描述
recraft_remove_background	移除背景并输出透明 PNG
recraft_vectorize	将栅格图像（PNG/JPG/WEBP）转换为 SVG
recraft_crisp_upscale	清晰放大图形、图标和插画
recraft_creative_upscale	使用 AI 增强细节并放大图像，适用于照片并支持面部优化
recraft_erase_region	智能移除经过遮罩的区域

风格管理

工具	功能
recraft_create_style	使用 1-5 张参考图像创建自定义风格
recraft_list_styles	列出账户中的自定义风格——免费，仅读取
recraft_get_style	按 ID 查找一种风格——免费，仅读取
recraft_delete_style	永久删除一种风格
recraft_list_basic_styles	从 API 实时获取 Recraft 各模型内置的风格

资源与账户

工具	说明
recraft_create_style	根据 1–5 张参考图创建自定义、可重复使用的风格
recraft_generate_asset	完整流程：生成 → 下载 → 可选移除背景 → 保存到文件
recraft_download_image	将图像 URL 保存到本地文件
recraft_check_credits	查看账户信息和剩余 API 点数

预览与成本

有两项行为值得了解，因为它们会影响 Agent 的能力。

预览。 生成工具会在返回 URL 的同时返回一张小型内嵌图像，因此模型可以实际查看结果——从四种变体中选出最佳方案、发现移除背景后留下了光晕，或看到文字变得难以辨认。预览会缩小至符合上下文预算（WebP，最长边 ≤768px，base64 ≤700KB），并且每次调用最多返回四张，因为无限量的 base64 数据所占用的上下文远超图像本身的价值。

图像无需评估时，可在单次调用中关闭预览：

recraft_generate_image(prompt: "...", preview: false)

成本。 每个 Recraft 响应都会注明相应调用消耗的点数，这里的每个工具都会传递该信息：

Model: recraftv4 | Size: 1024x1024 | Substyle: kawaii | Cost: 40 credits

这点比听起来更重要。创意放大需要消耗 250 点，而清晰放大只需 4 点——相差 62 倍；一套包含 12 个符号的主题素材大约需要 600 点。recraft_check_credits 可读取余额，风格管理工具则可免费读取，因此 Agent 可以先查看，再决定是否花费。

⚙️ 快速开始

需要 Node.js 20.9.0 或更新版本。1.1.0 版本升级了原生图像处理依赖，以修复已知的 libvips 漏洞；不再支持 Node.js 18。

1. 获取 Recraft API 密钥

在 recraft.ai 注册，并从账户设置中获取 API 密钥。

2. 安装并配置

claude mcp add --scope user recraft \
  -e RECRAFT_API_KEY=your-api-key-here \
  -- npx -y recraft-mcp-server

也可以手动将其添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "recraft": {
      "command": "npx",
      "args": ["-y", "recraft-mcp-server"],
      "env": {
        "RECRAFT_API_KEY": "your-api-key-here"
      }
    }
  }
}

环境变量

变量	说明
RECRAFT_API_KEY	你的 Recraft AI API 密钥

Docker

docker build -t recraft-mcp-server .
docker run -i --rm -e RECRAFT_API_KEY=your-key recraft-mcp-server

在 MCP 客户端配置中：

{
  "mcpServers": {
    "recraft": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "RECRAFT_API_KEY", "recraft-mcp-server"],
      "env": { "RECRAFT_API_KEY": "your-key" }
    }
  }
}

容器通过标准输入输出与 MCP 通信，且不会打开端口，因此必须使用 -i，而无需使用 -p。容器以非特权用户身份运行；需要写入文件的工具必须将目标目录绑定挂载（-v /path:/path）。

🤖 AI 提示词示例

游戏素材流程：

“生成一套风格统一的 6 个奇幻药水图标，然后导出 Pixi.js 清单。” → recraft_generate_themed_set

快速生成精灵图：

“生成一个 64x64 的像素风金币图标。” → recraft_generate_sized

风格探索：

“将这个 Logo 提示词以 4 种不同风格并排展示给我。” → recraft_compare_styles

照片修整：

“移除此照片的背景，并放大图像以供打印。” → recraft_remove_background → recraft_creative_upscale

替换素材：

“将精灵图集这个区域的纹理替换为新的设计。” → recraft_texture_swap

扩展画布：

“将这张图像扩展为 16:9 横幅，不要裁剪主体。” → recraft_outpaint

开放式探索：

“探索一些赛道赛车的创意，然后再给我一些类似第三个创意的方案。” → recraft_explore → recraft_explore_similar

润色提示词：

“生成前优化这条粗略提示词：‘举着牌子的红熊猫。’” → recraft_enhance_prompt

开发

git clone https://github.com/muhammetali/recraft-mcp-server.git
cd recraft-mcp-server
npm install
npm run build
npm test
npm run audit:security
npm run verify

1.2.0 版本使用官方模块化 MCP SDK v2，同时保留全部 24 个工具。有关发布检查、依赖决策和必要运行时能力，请参阅安全策略和依赖审查。

📄 许可证

MIT — 详见 LICENSE。