Recraft AI

Gere e edite imagens raster/vetoriais, vetorize, remova/substitua fundos e aumente a resolução usando a API Recraft AI.

Documentação


Recraft MCP Server

npm version npm downloads smithery badge

[!CAUTION]

Descontinuado

Este projeto está descontinuado. Nenhuma atualização, correção de bugs ou patch de segurança será publicada.

Use o servidor MCP remoto do Recraft em vez disso, disponível em https://mcp.recraft.ai/mcp, seguindo a documentação do servidor remoto. Ele não requer instalação local nem chave de API — a autenticação é feita via OAuth no seu navegador. Lembre-se de que o servidor MCP remoto usa um modelo de créditos diferente.

Para migrar no Claude Code:

claude mcp add --transport http recraft https://mcp.recraft.ai/mcp

Para migrar no Claude Desktop, substitua a entrada deste servidor no seu claude_desktop_config.json por:

{
  "mcpServers": {
    "recraft": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.recraft.ai/mcp"]
    }
  }
}

Para Cursor, VS Code e outros clientes MCP, consulte a documentação do servidor remoto.

Este é um servidor MCP (Model Context Protocol) que integra clientes MCP com as operações de imagem raster e vetorial do Recraft:

  • geração de imagens raster e vetoriais
  • edição de imagens raster e vetoriais
  • criação de estilos personalizados e geração de imagens neles
  • vetorização de imagens raster
  • remoção e substituição de fundo
  • ampliação (upscaling) de imagens raster

Ao conectar este servidor MCP ao seu cliente MCP, você poderá gerar imagens raster e vetoriais de alta qualidade usando o Recraft, combinando diferentes ferramentas.

Sumário

Configuração

Pré-requisitos

  • Antes de tudo, você precisará de uma chave da API do Recraft. Para obtê-la, registre sua conta no Recraft; depois acesse sua página de perfil da API. Aqui você pode comprar unidades de API (créditos) e gerar uma chave de API.

  • Você precisará ter um cliente MCP instalado, por exemplo o Claude Desktop.

Extensões do Claude Desktop

Se você estiver usando o Claude Desktop, pode configurar este servidor usando as Extensões do Claude Desktop.

  • Baixe mcp-recraft-server.dxt da última versão
  • Clique duas vezes no arquivo para abri-lo com o Claude Desktop
  • Clique em Instalar
  • Preencha o formulário
  • Ative o servidor

No formulário, você precisa colar sua chave de API do Recraft obtida na sua página de perfil da API. Você também pode especificar um caminho local para armazenamento das imagens geradas ou indicar que todos os resultados devem ser armazenados remotamente.

Em caso de problemas de instalação, verifique se você tem a versão mais recente do Claude Desktop.

Smithery

Você pode encontrar este servidor MCP no Smithery. Se este MCP for instalado a partir do Smithery, todos os resultados de geração serão armazenados remotamente. Use as Extensões do Desktop ou a Configuração Manual para armazenar os resultados de geração no seu dispositivo local.

Configuração Manual

Você precisará ter o Node em execução na sua máquina para poder executar os comandos npx ou node no seu terminal. Se você não tiver o Node, pode instalá-lo a partir do nodejs.org.

A partir do NPM

Modifique seu arquivo claude_desktop_config.json para adicionar o seguinte:

{
  "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>"
      }
    }
  }
}

A partir do código-fonte

Clone este repositório:

git clone https://github.com/recraft-ai/mcp-recraft-server.git

No diretório com o repositório clonado, execute:

npm install
npm run build

Modifique seu arquivo claude_desktop_config.json para adicionar o seguinte:

{
  "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>"
      }
    }
  }
}

Você pode especificar estes parâmetros:

  • RECRAFT_API_KEY: parâmetro obrigatório, sua chave da API do Recraft.
  • IMAGE_STORAGE_DIRECTORY: parâmetro opcional, você pode especificar o diretório no qual todas as imagens geradas serão armazenadas. Por padrão, este diretório é $HOME_DIR/.mcp-recraft-server. Se RECRAFT_REMOTE_RESULTS_STORAGE="1", o valor deste parâmetro é ignorado.
  • RECRAFT_REMOTE_RESULTS_STORAGE: parâmetro opcional, você pode definir o valor como "1"; neste caso, todas as imagens geradas serão armazenadas remotamente e suas URLs serão retornadas. Além disso, IMAGE_STORAGE_DIRECTORY será ignorado neste caso.

Ferramentas

Neste MCP, você pode usar as seguintes ferramentas:

Nome da FerramentaDescriçãoParâmetrosPreço
generate_imageGera imagens raster/vetoriais a partir de um prompt- prompt
- style
- size
- model
- número de imagens
$0.04/$0.08 por imagem raster/vetorial
create_styleCria um estilo a partir da lista de imagens- lista de imagens
- estilo básico
$0.04
vectorize_imageVetoriza imagem raster- imagem$0.01
image_to_imageGera imagens raster/vetoriais a partir de imagem e prompt- imagem
- prompt
- força de similaridade
- style
- size
- model
- número de imagens
$0.04/$0.08 por imagem raster/vetorial
remove_backgroundRemove o fundo da imagem- imagem$0.01
replace_backgroundGera um novo fundo na imagem a partir de um prompt- imagem
- prompt para o fundo
- style
- size
- model
- número de imagens
$0.04/$0.08 por imagem raster/vetorial
crisp_upscaleAmpliação nítida da imagem- imagem$0.004
creative_upscaleAmpliação criativa da imagem- imagem$0.25
get_userObter informações sobre o usuário e saldo restante

Você pode encontrar a explicação detalhada das ferramentas, seus parâmetros e preços na documentação da API do Recraft.