像素艺术生成工具

一款基于Google Gemini的像素艺术生成与处理工具,支持生成、裁剪、分割和处理游戏素材。

  • by freema
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 freema/pixelforge-mcp

使用说明

像素放大mcp

MCP服务器,使用Google Gemini伪造像素艺术精灵和游戏资产——生成、裁剪、分割和处理,所有这些都来自你的人工智能助手。

特性

  • 人工智能发电 --通过Google Gemini显示精灵、动画、背景、缩略图
  • 智能后处理 --背景移除、自动裁剪、像素缩小、方形填充
  • 雪碧片分割 --自动检测纸张并将其分割成单独的帧
  • 风格预设 --霓虹灯,复古,游戏男孩,打喷嚏,干净
  • 纯PNG管道 --零依赖PNG编码器/解码器,无原生模块
  • 参考匹配 --传递现有的精灵以匹配视觉风格

安装

克劳德代码(CLI)

claude mcp add pixelforge npx pixelforge-mcp@latest \
  --env GEMINI_API_KEY=your-api-key

克劳德代码(插件)

/plugin marketplace add freema/pixelforge-mcp
/plugin install pixelforge-mcp

重新启动Claude Code以加载MCP服务器(请检查 /mcp).

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "pixelforge": {
      "command": "npx",
      "args": ["-y", "pixelforge-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

手册(任何MCP客户端)

添加到您的 .mcp.json 或等效配置:

{
  "mcpServers": {
    "pixelforge": {
      "command": "npx",
      "args": ["-y", "pixelforge-mcp@latest"],
      "env": {
        "GEMINI_API_KEY": "your-api-key"
      }
    }
  }
}

需求

工具

forge_sprite

通过自动后处理(裁剪、背景图像删除、缩小比例、方形填充)生成单像素艺术精灵。

"Generate a green slime enemy sprite, 48px, retro style"

必修的: description, outputPath 可选: size (默认值:48), style, background, aspect, square, model, references

forge_animation

将动画帧生成为子画面,然后自动拆分为单独的帧PNG。

"Animate a slime bouncing, 4 frames"

必修的: description, action, outputPrefix 可选: frames (默认值:3), frameDescriptions, names, size, style, model, references

forge_background

生成完整的游戏背景——无裁剪,按原样输出图像。

"Deep space background with stars and nebula, 16:9"

必修的: description, outputPath, aspect 可选: style, model

forge_thumbnail

生成游戏缩略图/屏幕截图。通过 references 为了与你的精灵在视觉上保持一致。

"Space shooter scene with player ship vs alien rows"

必修的: description, outputPath 可选: references, aspect (默认值:4:3), style, model

process_sprite

对现有的PNG进行后处理——背景移除、自动裁剪、子画面分割。

"Split this sprite sheet into individual frames"

必修的: inputPath 可选: outputPath, split, names, threshold, square, padding, skipCrop, skipTransparent

optimize_sprite

使用面积平均(不是模糊的双线性)将超大AI图像缩小到真正的像素艺术分辨率。

"Optimize this 1024px image down to 48px pixel art"

必修的: inputPath, size 可选: outputPath, removeBackground, square

完整参数文档:请参阅 docs/tools.md

模型

别名 型号ID 备注
nano-banana, banana 纳米香蕉专业预览 默认 --最适合像素艺术
flash, gemini-flash gemini-3.1闪光图像回顾 快速、可靠
pro, gemini-pro gemini3-pro-image-review 最佳质量
25, gemini-25 gemini-2.5-flash-image 稳定回退

提示

pixel_art_guide

内置MCP提示,具有全面的像素艺术生成指南——提示规则、风格提示、尺寸建议和最佳实践。

许可证

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


建造于 托马斯·格拉斯尔