图像背景移除API服务

SimplyPNG-MCP是一个将SimplyPNG的背景移除功能暴露为MCP工具的服务,允许AI代理(如Claude、GPT等)无需用户界面交互即可编程处理图像。

  • by SimplyPNG
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 SimplyPNG/simplypng-mcp

使用说明

simplypng mcp

MCP服务器 SimplyPNG 背景移除API。

将SimplyPNG的背景删除功能显示为 MCP工具,让AI代理(Claude、GPT等)以编程方式处理图像,而无需UI交互。

工具

工具 说明
estimate_credits 处理前检查信贷成本
remove_background 从单个图像中删除背景
batch_remove_background 从多达50张图像中删除背景
get_job_status 轮询单个作业或批次的状态
download_results 获取已完成作业的签名下载URL

需求

  • Node.js 18+
  • SimplyPNG API密钥-获取https://simplypng.app/dashboard/api-keys

快速入门(本地/Claude桌面)

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

添加到您的Claude桌面配置(%AppData%\Claude\claude_desktop_config.json 在Windows上):

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

快速启动(HTTP/Remote)

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

环境变量

变量 必填 默认 描述
SIMPLYPNG_API_KEY 是 - 您的SimplyPNG API密钥
SIMPLYPNG_API_URL 没有 https://simplypng.app 转移覆盖
PORT 没有 3000 HTTP服务器端口(仅限HTTP传输)

复制 .env.example 到 .env 并填写您的密钥。

发展

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/

认证

此服务器是一个瘦适配器-您的API密钥通过 SIMPLYPNG_API_KEY 并转发为 Authorization: Bearer 至SimplyPNG API。服务器本身不存储凭据。

API密钥: sp_live_xxx (生产)或 sp_test_xxx (测试)。

信用额度使用

模式 每张图片的点数
快速(默认) 1学分(最大2500px)
HD(hdMode: true) 2学分(最多4096px)

使用 estimate_credits 在处理之前,请验证您是否有足够的余额。

许可证

麻省理工学院——见 许可证