AI导哈

AI图像生成服务器

基于Recraft API的AI图像生成、转换和风格管理服务器，支持文本到图像、图像到图像转换、背景替换等多种功能。

  • by BartWaardenburg
  • TypeScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 BartWaardenburg/recraft-mcp-server

使用说明

recraft-mcp

MCP server for AI image generation, transformation, and style management via the Recraft API

注： 这是一个非官方的、由社区维护的项目，不隶属于Recraft或得到Recraft的认可。

16工具 用于图像生成、处理和样式管理——所有这些都可以通过 模型上下文协议.

  • 生成 --文本到图像、图像到图像、修复、背景替换和生成
  • 过程 --背景移除、区域擦除、矢量化（SVG）、清晰且富有创意的放大
  • 风格 --从参考图像创建自定义样式，列出/获取/删除样式
  • 账户 --检查剩余积分和用户信息（包含在 styles 工具集）
  • 可配置的 --过滤工具集，调整缓存TTL，控制重试

先决条件

安装

克劳德桌面版

添加到您的配置文件中：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "recraft": {
      "command": "npx",
      "args": ["-y", "recraft-mcp"],
      "env": {
        "RECRAFT_API_TOKEN": "your-api-token"
      }
    }
  }
}

VS Code

添加 .vscode/mcp.json 在您的工作区中（或使用上面的一键安装按钮）：

{
  "servers": {
    "recraft": {
      "command": "npx",
      "args": ["-y", "recraft-mcp"],
      "env": {
        "RECRAFT_API_TOKEN": "your-api-token"
      }
    }
  }
}

克劳德代码

claude mcp add recraft-mcp -e RECRAFT_API_TOKEN=your-api-token -- npx -y recraft-mcp

光标

添加到Cursor的MCP设置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "recraft": {
      "command": "npx",
      "args": ["-y", "recraft-mcp"],
      "env": {
        "RECRAFT_API_TOKEN": "your-api-token"
      }
    }
  }
}

帆板运动

添加到Windsurf的MCP配置(~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "recraft": {
      "command": "npx",
      "args": ["-y", "recraft-mcp"],
      "env": {
        "RECRAFT_API_TOKEN": "your-api-token"
      }
    }
  }
}

码头工人

docker run --rm -i -e RECRAFT_API_TOKEN="your-api-token" ghcr.io/bartwaardenburg/recraft-mcp-server:latest

通过替换以下命令在任何MCP客户端中使用Docker：

{
  "mcpServers": {
    "recraft": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "RECRAFT_API_TOKEN=your-api-token",
        "ghcr.io/bartwaardenburg/recraft-mcp-server:latest"
      ]
    }
  }
}

史密瑟里

npx -y @smithery/cli install recraft-mcp --client claude

工具

生成

工具 说明
generate_image 从带有样式、大小和艺术控件的文本提示生成图像
image_to_image 基于强度可调的文本提示转换现有图像
inpaint_image 根据文本提示填充图像的蒙版区域
replace_background 替换背景，同时保留前景主体
generate_background 为图像的蒙版区域生成背景

处理

工具 说明
remove_background 删除背景，留下透明度
erase_region 从图像中无缝擦除蒙版区域
vectorize_image 将光栅图像转换为可缩放的SVG矢量
crisp_upscale 高档，细节保留清晰
creative_upscale 通过创意增强和添加细节来提升档次

样式和帐户

工具 说明
create_style 从1-5个参考图像创建自定义样式
get_style 按ID获取自定义样式的详细信息
list_styles 列出所有自定义样式
list_basic_styles 列出可用的精选风格
delete_style 删除自定义样式
get_current_user 获取用户信息和剩余积分

工具注释

所有工具包括 MCP工具注释 帮助客户了解他们的行为：

工具 只读 开放世界
generate_image 是
image_to_image 是
inpaint_image 是
replace_background 是
generate_background 是
remove_background 是
erase_region 是
vectorize_image 是
crisp_upscale 是
creative_upscale 是
create_style 是
get_style 是 是
list_styles 是 是
list_basic_styles 是 是
delete_style 是
get_current_user 是 是
Detailed Parameter Reference

generate_image

参数 类型 必填 说明
prompt string 是 文本描述（V2/V3最多1000个字符，V4最多10000个字符）
model 枚举 recraftv3 （默认）， recraftv4, recraftv4_vector, recraftv2, recraft20b, refm1
style 枚举 realistic_image （默认）， digital_illustration, vector_illustration, icon, logo_raster
substyle string 子样式细化（例如。 b_and_w, pixel_art, watercolor)
style_id uuid 自定义样式ID（与样式/子样式互斥）
size enum 图像维度，例如。 1024x1024 （默认）， 1365x1024, 1536x1024等等。
n integer 要生成的图像数量（1-6，默认为1）
negative_prompt string 图像中应避免的内容
artistic_level 整数 0（简单）到5（动态）
no_text boolean 阻止图像中的文本
image_format 枚举 webp 或 png
random_seed integer 用于可重复结果的种子

image_to_image

参数 类型 必填 说明
image string 是 源图像（URL或base64）。最大5MB，<16MP，每边最大4096px
prompt string 是 所需更改的描述
strength number Yes 更改幅度：0.0（最小）到1.0（最大）
model enum 要使用的模型
style enum 样式类别（V4不支持）
substyle string 子样式细化
style_id uuid 自定义样式ID
n integer 输出数量（1-6）
negative_prompt string 要避免什么
image_format 枚举 webp 或 png
random_seed integer 用于再现性的种子

inpaint_image

参数 类型 必填 说明
image string 是 源图像（URL或base64）
mask string 是 灰度PNG蒙版（白色=输入，黑色=保留）
prompt string 是 在掩码区域生成什么
model, style, substyle, style_id, n, negative_prompt, image_format, random_seed 与generate_image相同

replace_background

参数 类型 必填 说明
image string 是 源图像（URL或base64）
prompt string 是 新背景的描述
model, style, substyle, style_id, n, negative_prompt, image_format, random_seed 与generate_image相同

generate_background

参数 类型 必填 说明
image string 是 源图像（URL或base64）
mask string 是 定义背景区域的掩码
prompt string 是 要生成的背景描述
model, style, substyle, style_id, n, negative_prompt, image_format, random_seed 与generate_image相同

remove_background

参数 类型 必填 说明
image string 是 图像（URL或base64）
image_format 枚举 webp 或 png

erase_region

参数 类型 必填 说明
image string 是 源图像（URL或base64）
mask string 是 灰度掩码（白色=擦除，黑色=保留）
image_format 枚举 webp 或 png

vectorize_image

参数 类型 必填 说明
image string 是 要矢量化的图像（URL或base64）

crisp_upscale

参数 类型 必填 说明
image string 是 图像升级（URL或base64）。最大5MB，<4MP
image_format 枚举 webp 或 png

creative_upscale

参数 类型 必填 说明
image string 是 图像升级（URL或base64）。最大5MB，<16MP
image_format 枚举 webp 或 png

create_style

参数 类型 必填 说明
images string[] 是 1-5个参考图像（URL或base64）
style enum 是 基本样式类别

get_style

参数 类型 必填 说明
style_id uuid 是 要检索的样式ID

delete_style

参数 类型 必填 说明
style_id uuid 是 要删除的样式ID

list_styles, list_basic_styles, get_current_user

无需参数。

配置

环境变量 描述 默认值
RECRAFT_API_TOKEN 必修的。 你的 回收API代币 —
RECRAFT_TOOLSETS 逗号分隔的工具集可启用： generation, processing, styles 全部
RECRAFT_CACHE_TTL 缓存TTL（秒）(0 禁用） 120
RECRAFT_MAX_RETRIES 速率限制下的最大重试次数（429） 3

工具集筛选

通过仅启用所需的工具来减少暴露于LLM的工具数量：

# Only image generation
RECRAFT_TOOLSETS=generation

# Generation + processing, no style management
RECRAFT_TOOLSETS=generation,processing

支持的型号

型号 描述
recraftv3 重新起草V3（默认）
recraftv4 重新绘制V4（最新光栅）
recraftv4_vector 重新绘制V4矢量（SVG输出）
recraftv2 重新起草V2
recraft20b 重新起草20B（遗留）
refm1 参考M1

注： V4型号不支持 style 参数——使用提示来控制样式。

支持的样式

样式 子样式
realistic_image （默认） b_and_w, enterprise, hard_flash, hdr, motion_blur, natural_light, studio_portrait
digital_illustration pixel_art, hand_drawn, grain, infantile_sketch, 2d_art_poster, handmade_3d, engraving, comic_book
vector_illustration bold_stroke, chemistry, colored_stencil, contour_pop_art, flat_2, line_art, line_circuit
icon broken_line, colored_outline, colored_shapes, doodle_fill, doodle_offset_fill, offset_fill, outline
logo_raster —

图像输入

接受图像的工具(image_to_image, inpaint_image, remove_background等）支持：

  • 统一资源定位符 --任何可公开访问的HTTP（S）URL
  • Base64 --原始base64编码图像数据

安全

  • API令牌 --你的 RECRAFT_API_TOKEN 仅发送到Recraft API(https://external.api.recraft.ai).在进程生命周期之后，它永远不会被记录或存储。
  • 图像数据 --图像被发送到Recraft的服务器进行处理。磁盘上没有缓存图像数据。
  • 网络接入 --此服务器向以下对象发出出站HTTPS请求 external.api.recraft.ai 和 registry.npmjs.org （用于更新检查）。

看 安全.md 用于报告漏洞。

发展

pnpm install         # Install dependencies
pnpm dev             # Run with tsx (hot reload)
pnpm build           # Compile TypeScript
pnpm test            # Run tests
pnpm typecheck       # Type check

看 贡献.md 作为指导方针。

许可证

麻省理工学院

相关 MCP