https://github.com/recraft-ai/mcp-recraft-server
MCP (modelcontextprotocol) server implementation for Recraft AI API
https://github.com/recraft-ai/mcp-recraft-server
Last synced: 3 months ago
JSON representation
MCP (modelcontextprotocol) server implementation for Recraft AI API
- Host: GitHub
- URL: https://github.com/recraft-ai/mcp-recraft-server
- Owner: recraft-ai
- License: mit
- Created: 2025-05-19T15:47:37.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-05-30T13:48:40.000Z (4 months ago)
- Last Synced: 2025-05-30T18:51:57.632Z (4 months ago)
- Language: TypeScript
- Size: 101 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Recraft AI MCP Server
This is an MCP ([Model Context Protocol](https://modelcontextprotocol.io/)) Server integrating MCP Clients with [Recraft AI](https://recraft.ai/)'s raster and vector image operations:
- raster and vector images generation
- raster and vector images 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.
# 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 |
| `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 |
| `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 |
| `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 AI API docs](https://recraft.ai/docs).
# Setup
### Prerequisites
- First of all, you will need a [Recraft AI API](https://www.recraft.ai/docs) key. To obtain it, register your account on [Recraft AI](https://www.recraft.ai), 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're going to need Node working 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).
- You will need to have some MCP client installed, for example [Claude Desktop](https://claude.ai/download).
### Manual setup
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": ""
}
}
}
}
```
### Manual setup (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": ""
}
}
}
}
```
You can specify these parameters:
- `RECRAFT_API_KEY`: mandatory parameter, your [Recraft AI 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`.