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，控制重试

先决条件

• Node.js 20+（或Docker）
• A. 回收API代币

安装

克劳德桌面版

添加到您的配置文件中：

• 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

工具

生成

处理

样式和帐户

工具注释

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

Detailed Parameter Reference

generate_image

image_to_image

配置

工具集筛选

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

# Only image generation
RECRAFT_TOOLSETS=generation

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

支持的型号

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

支持的样式

图像输入

接受图像的工具(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 作为指导方针。

许可证

麻省理工学院