everart-forge-mcp

# EverArt Forge MCP for Cline  An advanced Model Context Protocol (MCP) server for [Cline](https://github.com/cline/cline) that integrates with EverArt's AI models to generate both vector and raster images. This server provides powerful image generation capabilities with flexible storage options and format conversion. ## Features - **Vector Graphics Generation** - Create SVG vector graphics using Recraft-Vector model - Automatic SVG optimization - Perfect for logos, icons, and scalable graphics - **Raster Image Generation** - Support for PNG, JPEG, and WebP formats - Multiple AI models for different styles - High-quality image processing - **Flexible Storage** - Custom output paths and filenames - Automatic directory creation - Format validation and extension handling - Web project integration ## Available Models - **5000:FLUX1.1**: Standard quality, general-purpose image generation - **9000:FLUX1.1-ultra**: Ultra high quality for detailed images - **6000:SD3.5**: Stable Diffusion 3.5 for diverse styles - **7000:Recraft-Real**: Photorealistic style - **8000:Recraft-Vector**: Vector art style (SVG output) ## Installation 1. Clone the repository: ```bash git clone https://github.com/nickbaumann98/everart-forge-mcp.git cd everart-forge-mcp ``` 2. Install dependencies: ```bash npm install ``` 3. Build the project: ```bash npm run build ``` 4. Get your EverArt API key: - Sign up at [EverArt](https://everart.ai/) - Navigate to your account settings - Create or copy your API key 5. Add the server to your Cline MCP settings file: **For VS Code Extension**: Edit `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`: ```json { "mcpServers": { "everart-forge": { "command": "node", "args": ["/absolute/path/to/everart-forge-mcp/build/index.js"], "env": { "EVERART_API_KEY": "your_api_key_here" }, "disabled": false, "autoApprove": [] } } } ``` **For Claude Desktop App**: Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or appropriate location for your OS 6. Restart Cline to load the new MCP server ## Usage Examples Once configured, you can use Cline to generate images with prompts like: - "Generate a minimalist tech logo in SVG format using the Recraft-Vector model" - "Create a photorealistic landscape image with the FLUX1.1-ultra model" - "Make me a vector icon for my project that represents artificial intelligence" - "Generate a professional company logo as an SVG file and save it to my desktop" ### Tool Capabilities The server provides these tools: #### generate_image Generate images with extensive customization options: ``` Parameters: - prompt (required): Text description of desired image - model: Model ID (5000:FLUX1.1, 9000:FLUX1.1-ultra, 6000:SD3.5, 7000:Recraft-Real, 8000:Recraft-Vector) - format: Output format (svg, png, jpg, webp) - output_path: Custom output path for the image - web_project_path: Path to web project root for proper asset organization - project_type: Web project type (react, vue, html, next, etc.) - asset_path: Subdirectory within the web project assets - image_count: Number of images to generate (1-10) ``` Notes: - SVG format is only available with Recraft-Vector (8000) model - Default format is "svg" for model 8000, "png" for others - You can specify combined model IDs (e.g., "8000:Recraft-Vector") #### list_images List all previously generated images stored by the server. #### view_image Open a specific image in the default image viewer: ``` Parameters: - filename: Name of the image file to view ``` ## Troubleshooting - **Error: Invalid model ID**: Make sure you're using one of the supported model IDs (5000, 6000, 7000, 8000, 9000) - **Format not compatible with model**: SVG format is only available with Recraft-Vector (8000) model - **Image not found**: Use the list_images tool to see available images - **API authentication failed**: Check your EverArt API key - **Images not appearing**: Check file permissions and paths ## License MIT License - see LICENSE file for details.