This is an MCP ([Model Context Protocol](https://modelcontextprotocol.io/)) server integrating MCP clients with [Recraft](https://recraft.ai/)'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
- [Table of Contents](#table-of-contents)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Claude Desktop Extensions](#claude-desktop-extensions)
- [Smithery](#smithery)
- [Manual Setup](#manual-setup)
- [From NPM](#from-npm)
- [From source](#from-source)
- [Tools](#tools)
# Setup
## Prerequisites
- First of all, you will need a [Recraft API](https://www.recraft.ai/docs) key. To obtain it, register your account on [Recraft](https://www.recraft.ai); then go to your [profile API page](https://www.recraft.ai/profile/api). 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](https://claude.ai/download).
## Claude Desktop Extensions
If you are using [Claude Desktop](https://claude.ai/download) you can set up this server using [Claude Desktop Extensions](https://www.anthropic.com/engineering/desktop-extensions).
- Download `mcp-recraft-server.dxt` from the [latest release](https://github.com/recraft-ai/mcp-recraft-server/releases/latest/download/mcp-recraft-server.dxt)
- 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](https://www.recraft.ai/profile/api). 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](https://claude.ai/download).
## Smithery
You can find this MCP server on [Smithery](https://smithery.ai/server/@recraft-ai/mcp-recraft-server). 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](https://nodejs.org/en/download).
### From NPM
Modify your `claude_desktop_config.json` file to add the following:
```json
{
"mcpServers": {
"recraft": {
"command": "npx",
"args": [
"-y",
"@recraft-ai/mcp-recraft-server@latest"
],
"env": {
"RECRAFT_API_KEY": "",
"IMAGE_STORAGE_DIRECTORY": "",
"RECRAFT_REMOTE_RESULTS_STORAGE": ""
}
}
}
}
```
### From source
Clone this repository:
```bash
git clone https://github.com/recraft-ai/mcp-recraft-server.git
```
In the directory with cloned repository run:
```bash
npm install
npm run build
```
Modify your `claude_desktop_config.json` file to add the following:
```json
{
"mcpServers": {
"recraft": {
"command": "node",
"args": ["/dist/index.js"],
"env": {
"RECRAFT_API_KEY": "",
"IMAGE_STORAGE_DIRECTORY": "",
"RECRAFT_REMOTE_RESULTS_STORAGE": ""
}
}
}
}
```
You can specify these parameters:
- `RECRAFT_API_KEY`: mandatory parameter, your [Recraft API](https://www.recraft.ai/profile/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`. If `RECRAFT_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_DIRECTORY` will 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](https://recraft.ai/docs).
