simplypng-mcp

MCP server for SimplyPNG background removal APIs.

Exposes SimplyPNG's background removal capabilities as MCP tools, letting AI agents (Claude, GPT, etc.) process images programmatically without UI interaction.

Tools

Related MCP server: forgemesh-imagegen

Requirements

• Node.js 18+

• A SimplyPNG API key — get one at https://simplypng.app/dashboard/api-keys

Quickstart (Local / Claude Desktop)

git clone https://github.com/SimplyPNG/simplypng-mcp.git
cd simplypng-mcp
npm install
npm run build

Add to your Claude Desktop config (%AppData%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "simplypng": {
      "command": "node",
      "args": ["C:\\path\\to\\simplypng-mcp\\build\\index.js"],
      "env": {
        "SIMPLYPNG_API_KEY": "sp_live_your_key_here"
      }
    }
  }
}

Quickstart (HTTP / Remote)

SIMPLYPNG_API_KEY=sp_live_your_key_here npm run serve
# MCP endpoint: POST http://localhost:3000/mcp

Environment Variables

Copy .env.example to .env and fill in your key.

Development

npm run dev        # stdio mode via tsx (no build step)
npm run serve      # HTTP mode via tsx
npm run type-check # TypeScript check without build
npm run build      # Compile to build/

Authentication

This server is a thin adapter — your API key is passed via SIMPLYPNG_API_KEY and forwarded as Authorization: Bearer to the SimplyPNG API. The server stores no credentials itself.

API keys: sp_live_xxx (production) or sp_test_xxx (testing).

Credit Usage

Use estimate_credits before processing to verify you have sufficient balance.

License

MIT — see LICENSE