pixel-art-mcp

simplepixelart-mcp

一个 MCP 服务，为 AI 助手（Claude、Cursor、Windsurf、VS Code……）提供真正的像素画工具：将任意图像转换为像素画、提取调色板、将精灵图重新着色为 PICO-8 或 Game Boy 色彩，以及无模糊放大。

在本地运行，支持 PNG 和 JPEG 文件或图像 URL，无需 API 密钥或原生依赖。

工具

工具	功能
pixelate_image	图像 → 像素画。将图像缩小到像素网格（例如宽 64 px），通过中位切分减少颜色数量至 N 种，或映射到指定调色板，并保存为 PNG（可选放大以供预览）。
extract_palette	提取图像中的主要颜色，并返回十六进制代码以及 GIMP / Aseprite .gpl 调色板。
remap_palette	重新着色现有像素画，让每个像素都使用调色板中的颜色——PICO-8、Sweetie 16、ENDESGA 32、Game Boy、1-bit，或你自己的十六进制列表。
upscale_pixel_art	使用最近邻算法按整数倍放大，保持像素清晰。
list_palettes	列出内置调色板。

安装

将其添加到 MCP 客户端配置中。适用于 Claude Desktop（claude_desktop_config.json）、Cursor（.cursor/mcp.json）和大多数其他客户端：

{
  "mcpServers": {
    "pixel-art": {
      "command": "npx",
      "args": ["-y", "simplepixelart-mcp"]
    }
  }
}

Claude Code：

claude mcp add pixel-art -- npx -y simplepixelart-mcp

需要 Node.js 18 或更高版本。

示例

可以向助手提出如下请求：

• “将 ~/photos/cat.jpg 转换为宽 48 px 的像素画，使用 PICO-8 调色板，并保存一张 8x 预览图。”
• “从这张截图中提取 6 色调色板，并提供 .gpl 文件。”
• “将 assets/ 中的所有精灵图重新着色为 Game Boy 调色板。”
• “将 hero.png 放大 10x，用于商店页面。”

作为库使用

import { loadImage, pixelate, saveImage } from 'simplepixelart-mcp/src/pixel.js'

const img = await loadImage('photo.jpg')
const { display, palette } = pixelate(img, { width: 64, palette: 'sweetie-16', scale: 8 })
await saveImage(display, 'photo-pixel.png')

想要编辑结果？

这些工具能为你生成干净的初始像素网格；手动修整才是乐趣所在。你可以在 SimplePixelArt 中打开 PNG。这是一款免费的在线 像素画编辑器，提供图层、动画和图块集工具；也可以试试其基于浏览器的 像素画转换器，进行实时调整。无需账户。

开发

npm install
npm test        # starts the server over stdio and calls every tool

许可证

MIT © Comficker