Recraft MCP Server
This is an MCP (Model Context Protocol) server integrating MCP clients with Recraft's raster- and vector-image operations:
- raster and vector image generation
- raster and vector image editing
- creating custom styles and generating images in them
- vectorization of raster images
- background removal and replacement
- upscaling of raster images
By connecting this MCP server to your MCP client you will be able to generate high-quality raster and vector images using Recraft, combining different tools.
Table of Contents
Setup
Prerequisites
-
First of all, you will need a Recraft API key. To obtain it, register your account on Recraft; then go to your profile API page. Here you can buy API units (credits) and generate an API key.
-
You will need to have an MCP client installed, for example Claude Desktop.
Claude Desktop Extensions
If you are using Claude Desktop you can set up this server using Claude Desktop Extensions.
- Download
mcp-recraft-server.dxtfrom the latest release - Double-click the file to open it with Claude Desktop
- Click Install
- Fill out the form
- Enable the server
In the form you need to paste your Recraft API key obtained on your profile API page. You can also specify a local path for generated image storage or indicate that all results should be stored remotely.
In case of installation issues, check that you have the latest version of Claude Desktop.
Smithery
You can find this MCP server on Smithery. If this MCP is installed from Smithery, all generation results will be stored remotely. Use Desktop Extensions or Manual Setup to store generation results on your local device.
Manual Setup
You're going to need Node running on your machine so you can run npx or node commands in your terminal. If you don't have Node, you can install it from nodejs.org.
From NPM
Modify your claude_desktop_config.json file to add the following:
{
"mcpServers": {
"recraft": {
"command": "npx",
"args": [
"-y",
"@recraft-ai/mcp-recraft-server@latest"
],
"env": {
"RECRAFT_API_KEY": "<YOUR_RECRAFT_API_KEY>",
"IMAGE_STORAGE_DIRECTORY": "<YOUR_IMAGE_STORAGE_DIRECTORY>",
"RECRAFT_REMOTE_RESULTS_STORAGE": "<YOUR_REMOTE_RESULTS_STORAGE_INDICATOR>"
}
}
}
}
From source
Clone this repository:
git clone https://github.com/recraft-ai/mcp-recraft-server.git
In the directory with cloned repository run:
npm install
npm run build
Modify your claude_desktop_config.json file to add the following:
{
"mcpServers": {
"recraft": {
"command": "node",
"args": ["<ABSOLUTE_PATH_TO_CLONED_DIRECTORY>/dist/index.js"],
"env": {
"RECRAFT_API_KEY": "<YOUR_RECRAFT_API_KEY>",
"IMAGE_STORAGE_DIRECTORY": "<YOUR_IMAGE_STORAGE_DIRECTORY>",
"RECRAFT_REMOTE_RESULTS_STORAGE": "<YOUR_REMOTE_RESULTS_STORAGE_INDICATOR>"
}
}
}
}
You can specify these parameters:
RECRAFT_API_KEY: mandatory parameter, your Recraft API key.IMAGE_STORAGE_DIRECTORY: optional parameter, you can specify the directory in which all generated images will be stored. By default this directory is$HOME_DIR/.mcp-recraft-server. IfRECRAFT_REMOTE_RESULTS_STORAGE="1", the value of this parameter is ignored.RECRAFT_REMOTE_RESULTS_STORAGE: optional parameter, you can set the value to"1", in this case all generated images will be stored remotely and their URLs will be returned. Also,IMAGE_STORAGE_DIRECTORYwill be ignored in this case.
Tools
In this MCP you can use the following tools:
| Tool Name | Description | Parameters | Price |
|---|---|---|---|
generate_image | Generates raster/vector images from prompt | - prompt - style - size - model - number of images | $0.04/$0.08 per raster/vector image |
create_style | Creates a style from the list of images | - list of images - basic style | $0.04 |
vectorize_image | Vectorizes raster image | - image | $0.01 |
image_to_image | Generates raster/vector images from image and prompt | - image - prompt - similarity strength - style - size - model - number of images | $0.04/$0.08 per raster/vector image |
remove_background | Removes background in image | - image | $0.01 |
replace_background | Generates new background in image from prompt | - image - prompt for background - style - size - model - number of images | $0.04/$0.08 per raster/vector image |
crisp_upscale | Crisp upscale of image | - image | $0.004 |
creative_upscale | Creative upscale of image | - image | $0.25 |
get_user | Get information about the user and left balance |
You can find the detailed explanation of tools, their parameters, and prices in Recraft API docs.