EverArt Forge MCP Server
# 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.