Poof

API de eliminación de fondos - elimina fondos de imágenes con una simple llamada a la API. Soporta salida en PNG, JPEG, WebP con transparencia o fondos personalizados.

GitHub

Documentación

@poof-bg/mcp

Servidor MCP (Model Context Protocol) para la API de eliminación de fondos de Poof. Usa asistentes de IA como Claude para eliminar fondos de imágenes.

¿Migrando desde remove.bg? Se cierra el 1 de diciembre de 2026 — consulta la guía de alternativa y migración desde remove.bg.

Características

remove_background - Elimina el fondo de imágenes (acepta base64 o URL)
get_account - Consulta la información de tu cuenta y saldo de créditos
Soporta transportes stdio (local) y HTTP (remoto/Cloudflare Worker)

Instalación

Local (transporte stdio)

npm install -g @poof-bg/mcp

O instala localmente:

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

Remoto (transporte HTTP vía Cloudflare Worker)

El servidor MCP de Poof se puede desplegar como un Cloudflare Worker, permitiendo acceso remoto vía HTTP.

Configuración

Variable de Entorno

Configura tu clave API de Poof:

export POOF_API_KEY=your_api_key_here

Obtén tu clave API en dash.poof.bg

Claude Code

OAuth (recomendado)

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

Clave API

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

Claude Desktop

Añade a tu archivo de configuración de Claude Desktop:

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

Opción 1: Remoto con OAuth (recomendado)

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

Opción 2: Local (transporte stdio)

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

Opción 3: Remoto con clave API

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

Cursor

Añade a .cursor/mcp.json en la raíz de tu proyecto (o configuración 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 con clave API

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

Windsurf

Añade a ~/.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 con clave API

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

VS Code + Copilot

Añade a tu settings.json de 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 con clave API

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

Cline (Extensión de VS Code)

Abre la configuración de Cline y añade a la configuración 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 con clave API

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

Herramientas

remove_background

Elimina el fondo de una imagen.

Parámetros:

Parámetro	Tipo	Requerido	Descripción
`image`	string	Sí	Imagen codificada en base64 o URL de una imagen
`format`	string	No	Formato de salida: `png`, `jpg`, `webp` (predeterminado: `png`)
`channels`	string	No	Canales de color: `rgba` para transparencia, `rgb` para opaco (predeterminado: `rgba`)
`bg_color`	string	No	Color de fondo al usar canales `rgb` (p. ej., `#ffffff`)
`size`	string	No	Preajuste de tamaño de salida: `full`, `preview`, `medium`, `hd` (predeterminado: `full`). Se ignora cuando se establece `width`/`height`
`crop`	boolean	No	Recortar a los límites del sujeto (predeterminado: `false`)
`width`	integer	No	Ancho de salida en píxeles (1-6000). Solo, la altura sigue la proporción de aspecto
`height`	integer	No	Alto de salida en píxeles (1-6000). Solo, el ancho sigue la proporción de aspecto
`fit`	string	No	Cómo ajustar a `width` x `height` sin estirar: `contain` (predeterminado, rellenar), `cover` (rellenar, recortar el exceso alrededor del sujeto), `scale-down` (rellenar, nunca ampliar)

Ejemplos 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én la información de tu cuenta y saldo de créditos.

Ejemplos de prompts:

Check my Poof account balance

How many credits do I have left?

Respuesta:

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

Desarrollo

# 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

Despliegue (Cloudflare Worker)

Para desplegar el servidor MCP como un Cloudflare Worker:

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

# Login to Cloudflare
wrangler login

# Deploy
wrangler deploy

Configura los secretos de entorno requeridos:

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

También configura la variable de URL del panel:

wrangler secret put DASHBOARD_URL

También necesitarás crear un espacio de nombres KV para el almacenamiento de estado de OAuth y actualizar los IDs en wrangler.toml:

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

Licencia

MIT

Poof

Documentación

@poof-bg/mcp

Características

Instalación

Local (transporte stdio)

Remoto (transporte HTTP vía Cloudflare Worker)

Configuración

Variable de Entorno

Claude Code

OAuth (recomendado)

Clave API

Claude Desktop

Opción 1: Remoto con OAuth (recomendado)

Opción 2: Local (transporte stdio)

Opción 3: Remoto con clave API

Cursor

OAuth (recomendado)

Local (stdio)

Remoto con clave API

Windsurf

OAuth (recomendado)

Local (stdio)

Remoto con clave API

VS Code + Copilot

OAuth (recomendado)

Local (stdio)

Remoto con clave API

Cline (Extensión de VS Code)

OAuth (recomendado)

Local (stdio)

Remoto con clave API

Herramientas

remove_background

get_account

Desarrollo

Despliegue (Cloudflare Worker)

Licencia

Enlaces