Content
<div align="center">
<h1>
<img src="images/recraft.svg" width="500px">
<br/>Recraft MCP Server
</h1>
<img src="https://badge.mcpx.dev?type=server" title="MCP Server"/>
<img src="https://img.shields.io/npm/v/@recraft-ai/mcp-recraft-server" alt="npm version"/>
<img src="https://img.shields.io/npm/dw/@recraft-ai/mcp-recraft-server" alt="npm downloads"/>
<a href="https://smithery.ai/server/@recraft-ai/mcp-recraft-server">
<img src="https://smithery.ai/badge/@recraft-ai/mcp-recraft-server" alt="smithery badge">
</a>
</div>
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": "<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:
```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": ["<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](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 <br/> - style <br/> - size <br/> - model <br/> - number of images | \$0.04/\$0.08 per raster/vector image |
| `create_style` | Creates a style from the list of images | - list of images <br/> - basic style | \$0.04 |
| `vectorize_image` | Vectorizes raster image | - image | \$0.01 |
| `image_to_image` | Generates raster/vector images from image and prompt | - image <br/> - prompt <br/> - similarity strength <br/> - style <br/> - size <br/> - model <br/> - 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 <br/> - prompt for background <br/> - style <br/> - size <br/> - model <br/> - 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).
