Poof

API de remoção de fundo - remova fundos de imagens com uma simples chamada de API. Suporta saída em PNG, JPEG, WebP com transparência ou fundos personalizados.

GitHub

Documentação

@poof-bg/mcp

Servidor MCP (Model Context Protocol) para a API de remoção de fundo do Poof. Use assistentes de IA como o Claude para remover fundos de imagens.

Migrando do remove.bg? Ele será descontinuado em 1º de dezembro de 2026 — veja o guia de migração e alternativa ao remove.bg.

Recursos

remove_background - Remove o fundo de imagens (aceita base64 ou URL)
get_account - Verifica informações da sua conta e saldo de créditos
Suporta transportes stdio (local) e HTTP (remoto/Cloudflare Worker)

Instalação

Local (transporte stdio)

npm install -g @poof-bg/mcp

Ou instale localmente:

git clone https://github.com/poof-bg/mcp.git
cd mcp
npm install
npm run build

Remoto (transporte HTTP via Cloudflare Worker)

O servidor MCP do Poof pode ser implantado como um Cloudflare Worker, permitindo acesso remoto via HTTP.

Configuração

Variável de Ambiente

Defina sua chave de API do Poof:

export POOF_API_KEY=your_api_key_here

Obtenha sua chave de API em dash.poof.bg

Claude Code

OAuth (recomendado)

claude mcp add --transport http poof https://api.poof.bg/mcp

Chave de API

claude mcp add --transport http poof https://api.poof.bg/mcp \
  --header "x-api-token: YOUR_POOF_API_KEY"

Claude Desktop

Adicione ao arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Opção 1: Remoto com OAuth (recomendado)

{
  "mcpServers": {
    "poof": {
      "url": "https://api.poof.bg/mcp"
    }
  }
}

Opção 2: Local (transporte stdio)

{
  "mcpServers": {
    "poof": {
      "command": "npx",
      "args": ["-y", "@poof-bg/mcp"],
      "env": {
        "POOF_API_KEY": "your_api_key_here"
      }
    }
  }
}

Opção 3: Remoto com chave de API

{
  "mcpServers": {
    "poof": {
      "url": "https://api.poof.bg/mcp",
      "headers": {
        "x-api-token": "YOUR_POOF_API_KEY"
      }
    }
  }
}

Cursor

Adicione ao .cursor/mcp.json na raiz do seu projeto (ou configuração global):

OAuth (recomendado)

{
  "mcpServers": {
    "poof": {
      "url": "https://api.poof.bg/mcp"
    }
  }
}

Local (stdio)

{
  "mcpServers": {
    "poof": {
      "command": "npx",
      "args": ["-y", "@poof-bg/mcp"],
      "env": {
        "POOF_API_KEY": "your_api_key_here"
      }
    }
  }
}

Remoto com chave de API

{
  "mcpServers": {
    "poof": {
      "url": "https://api.poof.bg/mcp",
      "headers": {
        "x-api-token": "YOUR_POOF_API_KEY"
      }
    }
  }
}

Windsurf

Adicione ao ~/.codeium/windsurf/mcp_config.json:

OAuth (recomendado)

{
  "mcpServers": {
    "poof": {
      "serverUrl": "https://api.poof.bg/mcp"
    }
  }
}

Local (stdio)

{
  "mcpServers": {
    "poof": {
      "command": "npx",
      "args": ["-y", "@poof-bg/mcp"],
      "env": {
        "POOF_API_KEY": "your_api_key_here"
      }
    }
  }
}

Remoto com chave de API

{
  "mcpServers": {
    "poof": {
      "serverUrl": "https://api.poof.bg/mcp",
      "headers": {
        "x-api-token": "YOUR_POOF_API_KEY"
      }
    }
  }
}

VS Code + Copilot

Adicione ao settings.json do seu VS Code:

OAuth (recomendado)

{
  "mcp": {
    "servers": {
      "poof": {
        "url": "https://api.poof.bg/mcp"
      }
    }
  }
}

Local (stdio)

{
  "mcp": {
    "servers": {
      "poof": {
        "command": "npx",
        "args": ["-y", "@poof-bg/mcp"],
        "env": {
          "POOF_API_KEY": "your_api_key_here"
        }
      }
    }
  }
}

Remoto com chave de API

{
  "mcp": {
    "servers": {
      "poof": {
        "url": "https://api.poof.bg/mcp",
        "headers": {
          "x-api-token": "YOUR_POOF_API_KEY"
        }
      }
    }
  }
}

Cline (Extensão do VS Code)

Abra as configurações do Cline e adicione à configuração de Servidores MCP:

OAuth (recomendado)

{
  "poof": {
    "url": "https://api.poof.bg/mcp"
  }
}

Local (stdio)

{
  "poof": {
    "command": "npx",
    "args": ["-y", "@poof-bg/mcp"],
    "env": {
      "POOF_API_KEY": "your_api_key_here"
    }
  }
}

Remoto com chave de API

{
  "poof": {
    "url": "https://api.poof.bg/mcp",
    "headers": {
      "x-api-token": "YOUR_POOF_API_KEY"
    }
  }
}

Ferramentas

remove_background

Remove o fundo de uma imagem.

Parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição
`image`	string	Sim	Imagem codificada em base64 ou URL de uma imagem
`format`	string	Não	Formato de saída: `png`, `jpg`, `webp` (padrão: `png`)
`channels`	string	Não	Canais de cor: `rgba` para transparência, `rgb` para opaco (padrão: `rgba`)
`bg_color`	string	Não	Cor de fundo ao usar canais `rgb` (ex.: `#ffffff`)
`size`	string	Não	Predefinição de tamanho de saída: `full`, `preview`, `medium`, `hd` (padrão: `full`). Ignorado quando `width`/`height` está definido
`crop`	boolean	Não	Recortar para os limites do assunto (padrão: `false`)
`width`	integer	Não	Largura de saída em pixels (1-6000). Sozinho, a altura segue a proporção
`height`	integer	Não	Altura de saída em pixels (1-6000). Sozinho, a largura segue a proporção
`fit`	string	Não	Como ajustar em `width` x `height` sem esticar: `contain` (padrão, preencher), `cover` (preencher, cortar o excesso ao redor do assunto), `scale-down` (preencher, nunca ampliar)

Exemplos de prompts:

Remove the background from this image: https://example.com/photo.jpg

Remove the background and add a white background instead

Remove the background and give me a 500x500 image with the product centred

get_account

Obtém informações da sua conta e saldo de créditos.

Exemplos de prompts:

Check my Poof account balance

How many credits do I have left?

Resposta:

{
  "success": true,
  "data": {
    "organizationId": "org_abc123",
    "plan": "Pro",
    "maxCredits": 5000,
    "usedCredits": 1234,
    "remainingCredits": 3766,
    "autoRechargeThreshold": 100
  }
}

Desenvolvimento

# Install dependencies
npm install

# Build
npm run build

# Run in dev mode (Cloudflare Worker)
npm run dev

# Run locally (stdio mode)
POOF_API_KEY=your_key npm start

# Lint
npm run lint

# Format
npm run format

Implantação (Cloudflare Worker)

Para implantar o servidor MCP como um Cloudflare Worker:

# Install Wrangler if you haven't already
npm install -g wrangler

# Login to Cloudflare
wrangler login

# Deploy
wrangler deploy

Defina os segredos de ambiente necessários:

wrangler secret put POOF_API_KEY
wrangler secret put MCP_JWT_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEY

Também defina a variável de URL do painel:

wrangler secret put DASHBOARD_URL

Você também precisará criar um namespace KV para armazenamento de estado OAuth e atualizar os IDs no wrangler.toml:

wrangler kv namespace create OAUTH_KV
wrangler kv namespace create OAUTH_KV --preview

Licença

MIT

Poof

Documentação

@poof-bg/mcp

Recursos

Instalação

Local (transporte stdio)

Remoto (transporte HTTP via Cloudflare Worker)

Configuração

Variável de Ambiente

Claude Code

OAuth (recomendado)

Chave de API

Claude Desktop

Opção 1: Remoto com OAuth (recomendado)

Opção 2: Local (transporte stdio)

Opção 3: Remoto com chave de API

Cursor

OAuth (recomendado)

Local (stdio)

Remoto com chave de API

Windsurf

OAuth (recomendado)

Local (stdio)

Remoto com chave de API

VS Code + Copilot

OAuth (recomendado)

Local (stdio)

Remoto com chave de API

Cline (Extensão do VS Code)

OAuth (recomendado)

Local (stdio)

Remoto com chave de API

Ferramentas

remove_background

get_account

Desenvolvimento

Implantação (Cloudflare Worker)

Licença

Links