v0.1.0
Pixel MCP Server v0.1.0 (2025-10-17T02:58:29Z)
Installation
Download the appropriate binary for your platform below, extract it, and add it to your PATH.
Alternatively, install with Go:
go install github.com/willibrandon/aseprite-mcp/cmd/aseprite-mcp@v0.1.0Configuration Required
Before using the server, create a configuration file at ~/.config/aseprite-mcp/config.json:
{
"aseprite_path": "/absolute/path/to/aseprite",
"temp_dir": "/tmp/aseprite-mcp",
"timeout": 30,
"log_level": "info"
}See README.md for full documentation.
Changelog
Features
- a2ae4e8: feat(canvas): implement delete_layer and delete_frame tools (Brandon Williams willibrandon@gmail.com)
- 08d2ce8: feat(ci): enhance CI workflow with Skia caching and Aseprite build steps (Brandon Williams willibrandon@gmail.com)
- 72b4cc9: feat(ci): implement CI workflow for Aseprite testing and Docker image build (Brandon Williams willibrandon@gmail.com)
- 3fa31cc: feat(docker): add Docker support for MCP server deployment (Brandon Williams willibrandon@gmail.com)
- 7f88d99: feat(drawing): implement draw_contour tool for polylines and polygons (Brandon Williams willibrandon@gmail.com)
- 1428dc6: feat(examples): add MCP client example with animation workflow (Brandon Williams willibrandon@gmail.com)
- 36ccfe0: feat(export): add advanced export and import tools (Brandon Williams willibrandon@gmail.com)
- 95b03eb: feat(logging): add opt-in request tracking and config-based logging (Brandon Williams willibrandon@gmail.com)
- c8fe046: feat(palette): implement palette management tools (get, set, add, sort) (Brandon Williams willibrandon@gmail.com)
- 921a9a1: feat(selection): implement Phase 2 selection and clipboard tools (REQ-SEL-001 to REQ-SEL-008) (Brandon Williams willibrandon@gmail.com)
- 13bcba7: feat(selection): implement persistent selections and clipboard via sprite.data (Brandon Williams willibrandon@gmail.com)
- 56d8279: feat(tests): add integration test for exporting specific frame with content (Brandon Williams willibrandon@gmail.com)
- f11df38: feat(tools): add draw_line, draw_rectangle, and draw_circle tools (Brandon Williams willibrandon@gmail.com)
- 2b10666: feat(tools): add export_sprite tool for image format conversion (Brandon Williams willibrandon@gmail.com)
- 0f95a30: feat(tools): add fill_area tool for flood fill operations (Brandon Williams willibrandon@gmail.com)
- 5ac33e4: feat(tools): implement add_layer and add_frame MCP tools (Brandon Williams willibrandon@gmail.com)
- 2f8a502: feat(tools): implement create_canvas MCP tool with validation (Brandon Williams willibrandon@gmail.com)
- a892020: feat(tools): implement draw_pixels MCP tool with batch operations (Brandon Williams willibrandon@gmail.com)
- c2c9eac: feat(tools): implement get_sprite_info MCP tool (Brandon Williams willibrandon@gmail.com)
- cc4d0d8: feat(transform): implement Phase 4 transform and filter tools (Brandon Williams willibrandon@gmail.com)
- c03c7ba: feat: add animation tools for frame timing and cel management (Brandon Williams willibrandon@gmail.com)
- 9ac59f4: feat: add antialiasing tool with edge detection and auto-smooth functionality (Brandon Williams willibrandon@gmail.com)
- 1011c2f: feat: add downsample_image tool for image downsampling with pagination support (Brandon Williams willibrandon@gmail.com)
- 2468016: feat: add get_pixels tool for reading pixel data from sprites (Brandon Williams willibrandon@gmail.com)
- 9016268: feat: add main entry point with cross-platform Makefile (Brandon Williams willibrandon@gmail.com)
- 8c4693f: feat: add palette management, shading, and color harmony tools (Brandon Williams willibrandon@gmail.com)
- 2ae4c68: feat: add palette-aware drawing with use_palette flag (Brandon Williams willibrandon@gmail.com)
- 3f27485: feat: add professional pixel art feature benchmarks for drawing, shading, and downsampling (Brandon Williams willibrandon@gmail.com)
- b1014e1: feat: add professional pixel art tools with k-means palette extraction and dithering (Brandon Williams willibrandon@gmail.com)
- 4f09534: feat: add testing guide and utilities for Aseprite MCP (Brandon Williams willibrandon@gmail.com)
- 03d8781: feat: enhance documentation and examples for professional pixel art tools, including dithering and palette extraction (Brandon Williams willibrandon@gmail.com)
- 1c6fef7: feat: implement Aseprite client and Lua script generation utilities (Brandon Williams willibrandon@gmail.com)
- 6e8d742: feat: implement MCP server initialization with stdio transport (Brandon Williams willibrandon@gmail.com)
- 1a32284: feat: implement configuration management and validation for Aseprite MCP (Brandon Williams willibrandon@gmail.com)
- 2ffcb17: feat: initialize project structure with essential files and configurations (Brandon Williams willibrandon@gmail.com)
Bug Fixes
- 36e1081: fix(analyze_reference): downsample edge detection to target resolution (Brandon Williams willibrandon@gmail.com)
- 5749649: fix(ci): add libxrandr-dev to Linux build dependencies (Brandon Williams willibrandon@gmail.com)
- 573e8a5: fix(ci): correct container image name to match ghcr.io package (Brandon Williams willibrandon@gmail.com)
- be90b9b: fix(ci): ensure consistent working directory for Go commands in CI workflow (Brandon Williams willibrandon@gmail.com)
- 55b9e41: fix(ci): exclude Aseprite from Go module scanning and update .gitignore (Brandon Williams willibrandon@gmail.com)
- 98be015: fix(ci): force Docker rebuild with native linux/amd64 platform (Brandon Williams willibrandon@gmail.com)
- a8d1816: fix(ci): handle first run and force rebuild of Docker image (Brandon Williams willibrandon@gmail.com)
- cca97e1: fix(ci): update Aseprite checkout path and adjust working directory in CI workflow (Brandon Williams willibrandon@gmail.com)
- b52273b: fix(ci): update Aseprite checkout path and installation directory in CI workflow (Brandon Williams willibrandon@gmail.com)
- 7668f11: fix(ci): update Aseprite checkout reference to v1.3.15.3 (Brandon Williams willibrandon@gmail.com)
- 53c7e6d: fix(ci): update Skia version in CI workflow to m124-08a5439a6b (Brandon Williams willibrandon@gmail.com)
- 3912089: fix(ci): update gofmt linting to exclude Aseprite and Skia directories (Brandon Williams willibrandon@gmail.com)
- 4e243f9: fix(ci): update gofmt linting to exclude specific directories (Brandon Williams willibrandon@gmail.com)
- 7c011ba: fix(dither): handle indexed color mode in draw_with_dither (Brandon Williams willibrandon@gmail.com)
- 9465c09: fix(dither): indexed color mode palette handling (Brandon Williams willibrandon@gmail.com)
- bfeea7c: fix(drawing): indexed color mode palette handling (Brandon Williams willibrandon@gmail.com)
- f095663: fix(drawing): indexed color mode palette handling (Brandon Williams willibrandon@gmail.com)
- 10b1fc3: fix(export): preserve indexed sprite palette in PNG export (Brandon Williams willibrandon@gmail.com)
- dff0b31: fix(export): preserve layer structure when exporting single frames (Brandon Williams willibrandon@gmail.com)
- b5175b8: fix(indexed): prevent palette index 0 pixels from being lost (Brandon Williams willibrandon@gmail.com)
- e285068: fix(tests): load Aseprite path from test config and handle loading errors (Brandon Williams willibrandon@gmail.com)
- 93a0bfe: fix: add missing newlines at the end of multiple files (Brandon Williams willibrandon@gmail.com)
- c3a71e7: fix: add missing newlines at the end of multiple files (Brandon Williams willibrandon@gmail.com)
- 21ceacd: fix: correct example client layer ordering and frame export (Brandon Williams willibrandon@gmail.com)
- 7294ae0: fix: correct repo name in README and skip environment-specific tests (Brandon Williams willibrandon@gmail.com)
- f66864a: fix: correct repository name in goreleaser config (Brandon Williams willibrandon@gmail.com)
- 058d92a: fix: remove .aseprite files from .gitignore and add Mona Lisa test asset (Brandon Williams willibrandon@gmail.com)
- d9412ef: fix: skip unwritable temp dir test when running as root (Brandon Williams willibrandon@gmail.com)
- c42452a: fix: update output directory paths in README and main.go for consistency (Brandon Williams willibrandon@gmail.com)
- 6f8bbbf: fix: use correct variable names for version ldflags (Brandon Williams willibrandon@gmail.com)
Performance Improvements
- df5a61a: perf: add benchmarks for critical operations and document results (Brandon Williams willibrandon@gmail.com)
Others
- 2574d2a: Add CLAUDE.md for project guidance and documentation (Brandon Williams willibrandon@gmail.com)
- 2fce057: Add Product Requirements Document for Aseprite MCP Server (Brandon Williams willibrandon@gmail.com)
- 3d94509: Add canvas and drawing tools with export functionality for Aseprite MCP server (Brandon Williams willibrandon@gmail.com)
- dba8bf5: Add configuration management and validation for Aseprite MCP server (Brandon Williams willibrandon@gmail.com)
- f28f7b9: Add initial design document for Aseprite MCP server implementation (Brandon Williams willibrandon@gmail.com)
- 083ba28: Add initial project structure with essential files including README, LICENSE, Makefile, and .gitignore; implement color handling in aseprite package with tests (Brandon Williams willibrandon@gmail.com)
- a38c62f: Add testing utilities and Lua script generation for Aseprite (Brandon Williams willibrandon@gmail.com)
- 0620619: Add unit tests for client functionality including script creation, cleanup, and error handling (Brandon Williams willibrandon@gmail.com)
- a786cc6: Delete all code (Brandon Williams willibrandon@gmail.com)
- b5a26ba: Update release date in PRD to reflect the correct version timeline and add implementation guide for Claude (Brandon Williams willibrandon@gmail.com)
- a9288e8: build(makefile): enhance build system with dev/release separation and test options (Brandon Williams willibrandon@gmail.com)
- 762bc98: ci: add Docker-based CI workflow with pre-built Aseprite container (Brandon Williams willibrandon@gmail.com)
- 918a14a: ci: add GitHub Actions workflow for cross-platform testing (Brandon Williams willibrandon@gmail.com)
- b5eff6a: refactor(ci): consolidate CI workflows and remove Docker build files (Brandon Williams willibrandon@gmail.com)
- f018e3c: refactor(docs): update CLAUDE.md and README.md (Brandon Williams willibrandon@gmail.com)
- 00488c0: refactor(tests): remove redundant pixel initialization in color format tests (Brandon Williams willibrandon@gmail.com)
- 2829650: refactor: fix linting warnings and remove unused code (Brandon Williams willibrandon@gmail.com)
Full Changelog: ...v0.1.0
For issues and support, visit: https://github.com/willibrandon/aseprite-mcp/issues