金大哥 - recraft-mcp-server MCP 详情

article

README

🚀 重构 MCP 服务器

这是一个实现与 Recraft.ai 服务集成的 Model Context Protocol (MCP) 服务器。借助该服务器，AI 助手能够通过 Recraft 的 API，利用 MCP 框架来生成图像。

🚀 快速开始

此服务器允许 AI 助手通过 Recraft 的 API 使用 MCP 框架生成图像，为图像生成工作提供了便利的解决方案。

✨ 主要特性

实现了 Recraft 图像生成服务的 MCP 工具，可无缝对接 Recraft 服务。
使用 Zod 进行类型安全的模式验证，确保数据的准确性和安全性。
支持多种图像生成选项（风格、大小等），满足多样化的图像生成需求。
方便与支持 MCP 的 LLM 助手集成，拓展应用场景。

📦 安装指南

先决条件

Node.js (建议 v18 或更高版本)
从 recraft.ai 获取的 Recraft API 密钥

安装步骤

克隆仓库：

git clone https://github.com/yourusername/recraft-mcp-server.git
cd recraft-mcp-server

安装依赖项：

npm install

复制环境文件并配置您的 API 密钥：

cp .env.example .env

然后编辑 .env 并添加您的 Recraft API 密钥。

🔧 配置

服务器使用以下环境变量： | 属性 | 详情 | |------|------| | RECRAFT_API_URL | Recraft API 终端点 (默认: https://external.api.recraft.ai) | | RECRAFT_API_KEY | 您的 Recraft API 密钥 |

💻 使用示例

基础用法

构建服务器

npm run build

启动服务器

npm start

或使用提供的 shell 脚本：

./start-mcp.sh

开发模式

npm run dev

检查 MCP 服务器

MCP SDK 包含一个检查工具来测试服务器：

npm run inspect

高级用法

运行测试

npm test

带覆盖范围的测试

npm run test:coverage

带有观察模式的测试

npm run test:watch

📚 详细文档

验证

该项目使用 Zod 进行模式验证。有关实现细节，请参阅 ZOD_IMPLEMENTATION.md。

API

此服务器实现了以下 MCP 工具：

generate_image：从文本提示生成图像
image_to_image：使用文本提示转换现有图像
inpaint_image：使用遮罩编辑图像的一部分
replace_background：替换图像的背景
vectorize_image：将位图图像转换为矢量格式
remove_background：从图像中移除背景
crisp_upscale：带有增强细节和清晰度的图像放大
creative_upscale：带有创意增强的图像放大
create_style：使用参考图像创建新风格
get_user_info：获取当前用户的信息
save_image_to_disk：将生成的图像保存到本地文件系统

服务器还响应一个特殊的 help 命令，提供有关可用工具的一般信息，但这是作为服务器逻辑中的特殊情况处理的，而不是正式的工具定义。

有关每个工具的可用参数和选项的详细信息，请使用 MCP 检查工具或查看代码中的工具定义。

开发

代码检查和修复

# 运行类型检查
npm run type-check

# 运行 eslint
npm run lint

# 修复 linting 问题
npm run lint:fix

# 同时运行类型检查和 linting
npm run validate

📄 许可证

本项目采用 MIT 许可证。

recraft-mcp-server