Recraft MCP Server

🚀 重構 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 密鑰

安裝步驟

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 密鑰。

🔧 配置

服務器使用以下環境變量：

💻 使用示例

基礎用法

構建服務器

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 許可證。