pixel-art-mcp

simplepixelart-mcp

AI アシスタント（Claude、Cursor、Windsurf、VS Code…）に実際のピクセルアートツールを提供する MCP サーバーです。画像をピクセルアートに変換したり、パレットを抽出したり、スプライトを PICO-8 や Game Boy のカラーに再配色したり、ぼかさずに拡大したりできます。

ローカルで動作し、PNG ファイル、JPEG ファイル、画像 URL に対応しています。API キーもネイティブ依存関係も不要です。

ツール

ツール	機能
pixelate_image	画像 → ピクセルアート。画像をピクセルグリッド（例：幅 64 px）に縮小し、メディアンカットで N 色に減色するか、名前付きパレットにマッピングして PNG に保存します（プレビュー用に任意で拡大できます）。
extract_palette	画像から主要なカラーを抽出し、16 進コードと GIMP / Aseprite の .gpl パレットを返します。
remap_palette	既存のピクセルアートを再配色し、すべてのピクセルにパレットのカラーを使用します。PICO-8、Sweetie 16、ENDESGA 32、Game Boy、1-bit、または独自の 16 進カラーリストに対応しています。
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 を PICO-8 パレットで幅 48 px のピクセルアートに変換して、8 倍のプレビューを保存して」
• 「このスクリーンショットから 6 色のパレットを抽出して、.gpl ファイルを作って」
• 「assets/ 内のすべてのスプライトを Game Boy パレットに再配色して」
• 「ストアページ用に hero.png を 10 倍に拡大して」

ライブラリとして使用する

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')

結果を編集したい場合

ツールを使うと、きれいなグリッドを出発点として作成できます。手作業で修正するのが楽しいところです。PNG を SimplePixelArt で開いてください。レイヤー、アニメーション、タイルセットのツールを備えた無料のオンライン ピクセルアートエディターです。または、リアルタイムで調整できるブラウザー内 ピクセルアートコンバーターもお試しください。アカウントは不要です。

開発

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

ライセンス

MIT © Comficker