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 在处理之前,请验证您是否有足够的余额。
许可证
麻省理工学院——见 许可证
