Skip to content

Add PixeloramaMCP extension#31

Open
VolkovIlia wants to merge 2 commits into
Orama-Interactive:mainfrom
VolkovIlia:add-pixelorama-mcp
Open

Add PixeloramaMCP extension#31
VolkovIlia wants to merge 2 commits into
Orama-Interactive:mainfrom
VolkovIlia:add-pixelorama-mcp

Conversation

@VolkovIlia

Copy link
Copy Markdown

Add PixeloramaMCP

MCP bridge for automating Pixelorama through Claude Code (or any MCP client).

What it does

TCP bridge extension that exposes 107 Pixelorama tools via the Model Context Protocol:

  • Drawing: lines, rectangles, ellipses, text, gradients, brushes (jitter, spray, blend modes)
  • Layers, frames, animation tags, FPS control
  • Canvas operations: fill, clear, resize, crop, snapshot
  • Tilemaps: tileset CRUD, cell operations, random fill
  • Effects: shader apply/inspect/list, layer effects
  • Export: PNG, GIF, APNG, spritesheet
  • Image-to-pixel-art conversion (photo → pixel art with palette reduction)
  • 3D objects, selections, palettes, symmetry

Demo

House with animated birds — drawn and exported entirely via MCP tools:

demo

Links

Note

The extension is distributed as .zip (not .pck) because it includes a Python MCP server component alongside the GDScript bridge. Installation requires extracting to the extensions directory. See README for details.

MCP bridge for automating Pixelorama through Claude Code (or any MCP client).
107 tools covering drawing, layers, animation, effects, tilemaps, brushes, and export.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings February 15, 2026 16:20

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds the PixeloramaMCP extension entry to Pixelorama’s online extension repository so it can be discovered/downloaded via the integrated extension explorer.

Changes:

  • Add a new repository entry for PixeloramaMCP (v0.1) including sha256, description, tags, thumbnail, and download link.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread extension_repository.md Outdated

[["name", "Skeletor"], ["version", 0.18], ["sha256", "83982fad08bdc8aa6a4ee775c2636fc897699caffcc3157c3a2b635b88e37092"], ["description", "This extension adds basic skeletal animation capabilities to pixelorama."], ["readme", "https://github.com/Variable-Interactive/Skeletor/blob/master/README.md"], ["tags", "Animation"], ["thumbnail", "https://github.com/user-attachments/assets/3f5ec294-600e-4cd4-9049-7c0124801662"], ["download_link", "https://github.com/Variable-Interactive/Skeletor/releases/download/v0.18/Skeletor.pck"]]

[["name", "PixeloramaMCP"], ["version", 0.1], ["sha256", "a1b342bdee7e65545544ca632dfed3c9a01d89310fd672ba4db60f819dca29e6"], ["description", "MCP bridge for automating Pixelorama through Claude Code or any MCP client. 107 tools: drawing, layers, animation, effects, tilemaps, brushes, export and more."], ["readme", "https://github.com/VolkovIlia/Pixelorama-mcp/blob/main/README.md"], ["tags", "Tool", "AI", "Automation"], ["thumbnail", "https://github.com/VolkovIlia/Pixelorama-mcp/raw/main/demo/house_birds.gif"], ["download_link", "https://github.com/VolkovIlia/Pixelorama-mcp/releases/download/v0.1.0/PixeloramaMCP.zip"]]

Copilot AI Feb 15, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

download_link points to a .zip release asset, but all existing repository entries (and the file’s examples) use .pck resource packs intended for in-app installation via Pixelorama’s extension explorer. If the explorer expects to load a resource pack, a .zip will likely fail to install; consider distributing a .pck (or otherwise confirm and document that the explorer can download + extract zips).

Suggested change
[["name", "PixeloramaMCP"], ["version", 0.1], ["sha256", "a1b342bdee7e65545544ca632dfed3c9a01d89310fd672ba4db60f819dca29e6"], ["description", "MCP bridge for automating Pixelorama through Claude Code or any MCP client. 107 tools: drawing, layers, animation, effects, tilemaps, brushes, export and more."], ["readme", "https://github.com/VolkovIlia/Pixelorama-mcp/blob/main/README.md"], ["tags", "Tool", "AI", "Automation"], ["thumbnail", "https://github.com/VolkovIlia/Pixelorama-mcp/raw/main/demo/house_birds.gif"], ["download_link", "https://github.com/VolkovIlia/Pixelorama-mcp/releases/download/v0.1.0/PixeloramaMCP.zip"]]
[["name", "PixeloramaMCP"], ["version", 0.1], ["sha256", "a1b342bdee7e65545544ca632dfed3c9a01d89310fd672ba4db60f819dca29e6"], ["description", "MCP bridge for automating Pixelorama through Claude Code or any MCP client. 107 tools: drawing, layers, animation, effects, tilemaps, brushes, export and more."], ["readme", "https://github.com/VolkovIlia/Pixelorama-mcp/blob/main/README.md"], ["tags", "Tool", "AI", "Automation"], ["thumbnail", "https://github.com/VolkovIlia/Pixelorama-mcp/raw/main/demo/house_birds.gif"], ["download_link", "https://github.com/VolkovIlia/Pixelorama-mcp/releases/download/v0.1.0/PixeloramaMCP.pck"]]

Copilot uses AI. Check for mistakes.
Comment thread extension_repository.md Outdated

[["name", "Skeletor"], ["version", 0.18], ["sha256", "83982fad08bdc8aa6a4ee775c2636fc897699caffcc3157c3a2b635b88e37092"], ["description", "This extension adds basic skeletal animation capabilities to pixelorama."], ["readme", "https://github.com/Variable-Interactive/Skeletor/blob/master/README.md"], ["tags", "Animation"], ["thumbnail", "https://github.com/user-attachments/assets/3f5ec294-600e-4cd4-9049-7c0124801662"], ["download_link", "https://github.com/Variable-Interactive/Skeletor/releases/download/v0.18/Skeletor.pck"]]

[["name", "PixeloramaMCP"], ["version", 0.1], ["sha256", "a1b342bdee7e65545544ca632dfed3c9a01d89310fd672ba4db60f819dca29e6"], ["description", "MCP bridge for automating Pixelorama through Claude Code or any MCP client. 107 tools: drawing, layers, animation, effects, tilemaps, brushes, export and more."], ["readme", "https://github.com/VolkovIlia/Pixelorama-mcp/blob/main/README.md"], ["tags", "Tool", "AI", "Automation"], ["thumbnail", "https://github.com/VolkovIlia/Pixelorama-mcp/raw/main/demo/house_birds.gif"], ["download_link", "https://github.com/VolkovIlia/Pixelorama-mcp/releases/download/v0.1.0/PixeloramaMCP.zip"]]

Copilot AI Feb 15, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thumbnail is set to an animated .gif, while all other entries use static image formats/links. If the extension explorer loads thumbnails via Godot image loaders, GIF may not be supported or may be large/slow to fetch; consider switching to a static PNG/JPG thumbnail consistent with the rest of the repository.

Suggested change
[["name", "PixeloramaMCP"], ["version", 0.1], ["sha256", "a1b342bdee7e65545544ca632dfed3c9a01d89310fd672ba4db60f819dca29e6"], ["description", "MCP bridge for automating Pixelorama through Claude Code or any MCP client. 107 tools: drawing, layers, animation, effects, tilemaps, brushes, export and more."], ["readme", "https://github.com/VolkovIlia/Pixelorama-mcp/blob/main/README.md"], ["tags", "Tool", "AI", "Automation"], ["thumbnail", "https://github.com/VolkovIlia/Pixelorama-mcp/raw/main/demo/house_birds.gif"], ["download_link", "https://github.com/VolkovIlia/Pixelorama-mcp/releases/download/v0.1.0/PixeloramaMCP.zip"]]
[["name", "PixeloramaMCP"], ["version", 0.1], ["sha256", "a1b342bdee7e65545544ca632dfed3c9a01d89310fd672ba4db60f819dca29e6"], ["description", "MCP bridge for automating Pixelorama through Claude Code or any MCP client. 107 tools: drawing, layers, animation, effects, tilemaps, brushes, export and more."], ["readme", "https://github.com/VolkovIlia/Pixelorama-mcp/blob/main/README.md"], ["tags", "Tool", "AI", "Automation"], ["thumbnail", "https://github.com/VolkovIlia/Pixelorama-mcp/raw/main/demo/house_birds.png"], ["download_link", "https://github.com/VolkovIlia/Pixelorama-mcp/releases/download/v0.1.0/PixeloramaMCP.zip"]]

Copilot uses AI. Check for mistakes.
- download_link: .zip -> .pck (Godot resource pack)
- thumbnail: .gif -> .png (static image)
- sha256: updated for .pck file

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@VolkovIlia

Copy link
Copy Markdown
Author

Updated based on review feedback:

  1. .zip.pck — now distributing as Godot resource pack (PixeloramaMCP.pck, 134KB)
  2. GIF → PNG — switched thumbnail to static PNG image
  3. SHA256 — recalculated for the .pck file

Ready for review. @Variable-ind @OverloadedOrama

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants