SVG.new

Um servidor Model Context Protocol que fornece a qualquer cliente MCP ferramentas de imagem para SVG: vetorizar, recolorir, simplificar, remover fundos e converter em lote. Ele roda localmente com npx e sua chave de API SVG.new.

SVG_NEW_API_KEY=svk_your_key_here npx -y @svgnew/mcp

Configure o servidor MCP SVG

Funciona da mesma forma em qualquer cliente que execute servidores MCP stdio.

1

Crie uma chave de API

Entre em svg.new/account e crie uma chave. As chaves começam com svk_ e são exibidas apenas uma vez.

2

Adicione o servidor ao seu cliente

A maioria dos clientes aceita o JSON padrão mcpServers. O Node.js deve estar instalado para que o npx possa executar o pacote.

{
  "mcpServers": {
    "svg-new": {
      "command": "npx",
      "args": ["-y", "@svgnew/mcp"],
      "env": { "SVG_NEW_API_KEY": "svk_your_key_here" }
    }
  }
}

3

Peça ao seu agente para vetorizar

Reinicie ou atualize o cliente e peça algo como "Vetorize logo.png e salve como logo.svg". O agente descobre as ferramentas por conta própria.

Ferramentas

Dez ferramentas, todas com suporte da API REST SVG.new. As entradas de imagem são URLs de dados base64; as variantes _file aceitam arquivos anexados pelo cliente.

vectorize

Entrada: imagem

Converte uma imagem PNG, JPG ou WebP (URL de dados base64) em SVG. Retorna o SVG e um ID de vetorização.

1 crédito

vectorize_file

Entrada: arquivo

Igual à vetorização, para um arquivo PNG, JPG ou WebP que o cliente anexa (uma URL de download), como fazem os aplicativos ChatGPT e hosts semelhantes.

1 crédito

recolor_svg

Entrada: svg, color_map

Substitui cores em um SVG usando um mapa de valores hexadecimais antigos para novos.

Grátis

simplify_svg

Entrada: svg, max_colors

Reduz um SVG a no máximo max_colors cores (1 a 256).

Grátis

remove_background

Entrada: svg, imagem

Remove o fundo de um SVG, usando a imagem raster original como referência.

1 crédito

remove_background_file

Entrada: svg, arquivo

Igual a remove_background, com a imagem original fornecida como arquivo anexado.

1 crédito

batch_vectorize

Entrada: imagens

Envia de 1 a 10 imagens para vetorização e retorna um ID de lote.

1 crédito por imagem

batch_vectorize_files

Entrada: arquivos

Envia até 10 arquivos anexados para vetorização e retorna um ID de lote.

1 crédito por imagem

get_batch_status

Entrada: batch_id

Relata o progresso e os itens concluídos de um lote.

Grátis

list_vectorizations

Entrada: nenhuma

Lista suas 20 vetorizações mais recentes.

Grátis

Configuração para cada cliente

Claude Desktop

Adicione em claude_desktop_config.json (Configurações, Desenvolvedor, Editar Configuração) e reinicie o Claude Desktop.

{
  "mcpServers": {
    "svg-new": {
      "command": "npx",
      "args": ["-y", "@svgnew/mcp"],
      "env": { "SVG_NEW_API_KEY": "svk_your_key_here" }
    }
  }
}

Claude Code

Execute uma vez no seu terminal. Consulte o guia do Claude Code para o plugin baseado em habilidades.

claude mcp add svg-new \
  -e SVG_NEW_API_KEY=svk_your_key_here \
  -- npx -y @svgnew/mcp

Cursor

Adicione em ~/.cursor/mcp.json ou no .cursor/mcp.json de um projeto. Guia do Cursor.

{
  "mcpServers": {
    "svg-new": {
      "command": "npx",
      "args": ["-y", "@svgnew/mcp"],
      "env": { "SVG_NEW_API_KEY": "svk_your_key_here" }
    }
  }
}

Windsurf

Adicione em ~/.codeium/windsurf/mcp_config.json e atualize os servidores MCP no Cascade. Guia do Windsurf.

{
  "mcpServers": {
    "svg-new": {
      "command": "npx",
      "args": ["-y", "@svgnew/mcp"],
      "env": { "SVG_NEW_API_KEY": "svk_your_key_here" }
    }
  }
}

OpenAI Codex

Execute uma vez no seu terminal; o Codex salva em ~/.codex/config.toml. Guia do Codex.

codex mcp add svg-new \
  --env SVG_NEW_API_KEY=svk_your_key_here \
  -- npx -y @svgnew/mcp

Autenticação e configurações

O servidor lê duas variáveis de ambiente. Ele encerra na inicialização se a chave estiver ausente, então um cliente que mostra o servidor como falho geralmente significa que a chave não foi repassada.

SVG_NEW_API_KEY obrigatório

Sua chave de API de svg.new/account. Enviada para svg.new como um token Bearer.

SVG_NEW_API_URL opcional

URL base da API. O padrão é https://svg.new.

Prefere HTTP simples? As mesmas operações estão na documentação da API REST.

Perguntas frequentes

O que é o servidor MCP SVG.new?

É um servidor MCP SVG publicado no npm como @svgnew/mcp. Ele fala o Model Context Protocol via stdio e expõe dez ferramentas (vectorize, vectorize_file, recolor_svg, simplify_svg, remove_background, remove_background_file, batch_vectorize, batch_vectorize_files, get_batch_status, list_vectorizations) que chamam a API SVG.new com sua chave.

Como vetorizo uma imagem via MCP?

Adicione o servidor ao seu cliente MCP e peça ao agente para vetorizar uma imagem. Para vetorizar uma imagem via MCP, o agente chama a ferramenta vectorize com a imagem como URL de dados base64 (por exemplo, data:image/png;base64,...). A ferramenta retorna o markup SVG e um ID, e o agente salva o SVG onde você pediu.

Quais clientes podem usar o servidor MCP de imagem para SVG?

Qualquer cliente que possa iniciar um servidor MCP stdio local, incluindo Claude Desktop, Claude Code, Cursor, Windsurf e OpenAI Codex. O servidor precisa do Node.js para que o npx possa executá-lo.

Como funciona a autenticação?

Crie uma chave de API em svg.new/account e passe-a ao servidor como a variável de ambiente SVG_NEW_API_KEY. O servidor a envia para svg.new como um token Bearer. As chaves começam com svk_, são exibidas apenas uma vez e podem ser revogadas na página da sua conta a qualquer momento.

Quanto custa o servidor MCP?

O servidor é gratuito para instalar. As chamadas de ferramentas usam créditos SVG.new: vectorize e remove_background custam 1 crédito, batch_vectorize custa 1 crédito por imagem, e as ferramentas de edição e status são gratuitas. Uma conta gratuita inclui 3 vetorizações por dia; o Pro custa US$ 9,99 por mês para 1.000.

Há limites de tamanho ou taxa?

As imagens são enviadas como base64 e as solicitações são limitadas a cerca de 4,5 MB, então mantenha cada imagem de origem abaixo de aproximadamente 3 MB. A vetorização permite 10 solicitações por minuto, e um lote comporta até 10 imagens.