Recraft MCP 服务器

一个用于与 Recraft.ai 服务集成的 Model Context Protocol (MCP) 服务器实现。此服务器使AI助手能够通过Recraft的API使用MCP框架生成图像。

🌟 功能

• 实现了用于Recraft图像生成服务的MCP工具
• 使用Zod提供类型安全的模式进行验证
• 支持多种图像生成选项（风格、大小等）
• 便于与支持MCP的LLM助手集成

📋 先决条件

• Node.js（推荐v18或更高版本）
• 从 recraft.ai 获取的Recraft API密钥

🚀 安装

1. 克隆仓库：

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

2. 安装依赖：

   npm install
   

3. 复制环境文件并配置您的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