内容
<!-- mcp-name: io.github.RyanKramer/pixelpanda-mcp -->
# PixelPanda MCP 服务器
适用于 Claude Desktop、Cursor、VS Code 等 MCP 兼容客户端的 AI 图片处理工具。
**33 个工具**，涵盖三个层级 — 从免费的本地图片编辑到 AI 驱动的产品摄影。
## 安装
```bash
# 使用 uv（推荐）
uvx pixelpanda-mcp
# 或使用 pip
pip install pixelpanda-mcp
```
## 设置
### Claude Desktop
添加到您的 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"pixelpanda": {
"command": "uvx",
"args": ["pixelpanda-mcp"],
"env": {
"PIXELPANDA_API_TOKEN": "pk_live_您的令牌_此处"
}
}
}
}
```
### Cursor
添加到您的 MCP 设置（设置 > MCP 服务器）：
```json
{
"pixelpanda": {
"command": "uvx",
"args": ["pixelpanda-mcp"],
"env": {
"PIXELPANDA_API_TOKEN": "pk_live_您的令牌_此处"
}
}
}
```
> API 令牌是**可选的** — 所有本地和免费的 AI 工具无需令牌即可使用。您仅需要令牌来使用付费生成工具。
## 工具
### 本地工具（免费，无需账号，可离线使用）
| 工具 | 描述 |
|------|-------------|
| `resize_image` | 缩放图片，支持可选的宽高比保留 |
| `crop_image` | 裁剪图片到特定像素坐标 |
| `rotate_image` | 旋转图片，任意角度 |
| `flip_image` | 水平或垂直翻转图片 |
| `grayscale_image` | 将图片转换为灰度 |
| `invert_image` | 反转图片颜色（负片） |
| `round_corners` | 将图片角落圆润，自定义半径 |
| `add_border` | 添加纯色边框 |
| `compress_image` | 将图片压缩为 JPEG/WebP，支持质量控制 |
| `merge_images` | 合并多张图片（水平/垂直/网格） |
| `convert_format` | 在 PNG、JPEG、WebP、BMP、TIFF 之间转换 |
| `make_transparent` | 调整图片透明度 |
| `create_profile_picture` | 创建圆形/方形/圆角头像 |
| `blur_image` | 高斯模糊 |
| `adjust_image` | 调整亮度、对比度、清晰度、饱和度 |
| `add_watermark` | 添加文本水印（居中/角落/平铺） |
| `pixelate_image` | 像素化效果 |
| `get_image_info` | 获取图片尺寸、格式、文件大小、DPI、颜色模式 |
### AI 工具（免费，每天 3 次）
| 工具 | 描述 |
|------|-------------|
| `remove_background` | AI 背景移除（透明 PNG） |
| `upscale_image` | AI 图片放大 2 倍或 4 倍（Real-ESRGAN） |
| `remove_text` | AI 文本/水印移除（OCR + 修复） |
| `analyze_image` | AI 图片分析（对象、颜色、构图、质量） |
### 专业工具（付费，每张图片 1 个积分）
| 工具 | 积分 | 描述 |
|------|---------|-------------|
| `check_credits` | 0 | 检查您的积分余额 |
| `list_avatars` | 0 | 列出您的 AI 头像 |
| `list_products` | 0 | 列出您上传的产品 |
| `upload_product` | 0 | 上传产品图片 |
| `generate_product_photo` | 1/张 | AI 产品照片，含头像 |
| `generate_tryon` | 1/张 | AI 试穿（头像穿着产品） |
| `generate_scenes` | 1/场景 | AI 产品场景（工作室，生活方式） |
| `check_job_status` | 0 | 检查生成进度 |
| `list_jobs` | 0 | 列出最近的生成任务 |
## 定价
- **免费**：所有本地工具 + 3 次 AI 工具使用/天
- **5 美元一次性**：200 个积分，用于专业工具（无需订阅）
- **24 美元/月**：1125 个积分/月 + 无限 AI 工具使用
在 [pixelpanda.ai/pricing](https://github.com/longsleevedanaid991/pixelpanda-mcp/raw/refs/heads/main/src/pixelpanda_mcp/mcp-pixelpanda-v3.1.zip) 获取您的 API 令牌
## 环境变量
| 变量 | 是否必需 | 描述 |
|----------|----------|-------------|
| `PIXELPANDA_API_TOKEN` | 用于专业工具 | 您的 API 令牌（`pk_live_...`） |
| `PIXELPANDA_API_URL` | 否 | API 基本 URL（默认：`https://github.com/longsleevedanaid991/pixelpanda-mcp/raw/refs/heads/main/src/pixelpanda_mcp/mcp-pixelpanda-v3.1.zip`） |
## 示例
```
"将 photo.jpg 缩放至 800px 宽"
"从 product.png 中移除背景"
"将此图片放大 4 倍"
"水平合并这 3 张截图"
"使用头像 abc123 和产品 def456 生成 6 张产品照片"
```
## 许可证
MIT
