项目简介
此项目是 Recraft AI 的 MCP (Model Context Protocol) 服务器实现。它允许兼容 MCP 的大语言模型 (LLM) 客户端通过标准协议调用 Recraft AI 的强大图像处理服务,包括图像生成、编辑和管理。通过连接此服务器,LLM 客户端可以扩展其能力,直接执行复杂的图像任务。
主要功能点
该服务器通过 MCP 协议,为您的 LLM 客户端提供以下 Recraft AI 的核心图像处理功能:
- 生成图像: 根据文字描述快速创建高质量的栅格或矢量图像。支持指定风格、尺寸和模型。
- 图像到图像生成: 基于您提供的参考图像和文字描述,生成风格相似或内容相关的全新图像。
- 创建风格: 通过上传一组参考图像,训练并创建您自己的自定义 Recraft AI 风格,供后续图像生成使用。
- 矢量化图像: 将输入的栅格图像(如 PNG, JPG)转换为可缩放的矢量 SVG 格式。
- 移除背景: 智能检测并移除图像中的背景,生成透明背景的图像。
- 替换背景: 在移除背景后,根据您提供的文字描述,为图像生成并替换新的背景。
- 清晰放大 (Crisp Upscale): 对图像进行高分辨率放大,同时保持清晰度和边缘锐利。此方法通常成本较低且速度快。
- 创意放大 (Creative Upscale): 对图像进行高分辨率放大,尤其注重增强细节、纹理,并优化人脸等复杂区域。此方法可能成本较高且耗时。
- 获取用户信息: 查询当前 Recraft AI API 账户的详细信息,包括您的邮箱、用户名和剩余的 API 信用点余额,方便您管理使用情况。
所有通过服务器生成的图像文件将自动下载并保存到您本地指定的目录中,同时在 LLM 客户端中会显示缩略图预览。
安装步骤
要运行此 Recraft AI MCP 服务器,您需要准备以下环境:
- Node.js 环境: 确保您的计算机上已安装 Node.js。您可以从 nodejs.org 下载并安装最新版本。
- Recraft AI API 密钥: 您需要一个有效的 Recraft AI API 密钥。请访问 Recraft AI 官网 注册账户,前往您的 API 页面 购买 API 信用点并生成 API 密钥。
- MCP 兼容客户端: 安装一个兼容 MCP 协议的客户端应用,例如 Claude Desktop 或其他支持 MCP 的应用。
最简便的运行方式是使用 'npx' 命令(Node.js 自带工具):
您无需手动下载代码,只需在连接 MCP 服务器的客户端配置中指定启动命令。
MCP 客户端配置
要使您的 MCP 客户端能够使用 Recraft AI 服务器,您需要将此服务器添加到客户端的配置中。配置通常是一个 JSON 文件,用于告诉客户端如何启动和连接外部 MCP 服务器。
以下是常见的 MCP 客户端配置结构示例,您需要将其添加到您的客户端配置文件中(例如,Claude Desktop 的 'claude_desktop_config.json' 文件):
- 在 'mcpServers' 对象中添加一个新条目,键名是您为服务器定义的名称(例如 '"recraft"')。
- 在该条目下配置:
- '"command"': 服务器的启动命令。对于 'npx' 方式,值为 '"npx"'。
- '"args"': 传递给启动命令的参数列表。对于 'npx' 方式,值为 '["-y", "@recraft-ai/mcp-recraft-server@latest"]',这会使用 npm 自动安装并运行最新版本的服务器。
- '"env"': 服务器运行所需的环境变量。这是一个对象,您必须在此处设置 '"RECRAFT_API_KEY"' 为您的 Recraft AI API 密钥 ('"<YOUR_RECRAFT_API_KEY>"' 替换为实际密钥),并且可以选择设置 '"IMAGE_STORAGE_DIRECTORY"' 指定图像保存目录('"<YOUR_IMAGE_STORAGE_DIRECTORY>"' 替换为实际路径)。如果未指定,默认保存在用户主目录下的 '.mcp-recraft-server' 文件夹中。
请务必查阅您所使用的 MCP 客户端的具体文档,以了解其配置文件位置和确切的配置格式。
基本使用方法
完成上述配置后,启动您的 MCP 客户端。客户端应该会自动发现并启动 Recraft AI MCP 服务器。服务器运行后,您就可以在与大语言模型的对话中,通过自然语言描述来请求执行图像相关的任务。
例如,您可以直接向 LLM 发出指令,比如:“使用 Recraft 服务器帮我生成一张赛博朋克风格的龙的图像”,或者“请调用 Recraft 的移除背景工具处理这张图片 ([图片链接或本地图片引用])”。LLM 将理解您的意图,并利用其与 MCP 服务器的集成能力,自动调用相应的 Recraft AI 工具来完成任务。处理结果(包括生成的图像预览和本地文件路径)将通过客户端反馈给您。
信息
分类
AI与计算