Aseprite MCP Server
A Model Context Protocol (MCP) server that exposes Aseprite's pixel art and animation capabilities to AI assistants, enabling you to create and edit sprites using natural language.
![]()
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
A Model Context Protocol (MCP) server that exposes Aseprite's pixel art and animation capabilities to AI assistants, enabling you to create and edit sprites using natural language.
![]()
MCP server for creating pixel art with Aseprite through AI assistants. Supports animation, retro palettes, dithering, shading, and spritesheet export.
Example scene created using pixel-mcp: 64x64 indexed sprite with custom 16-color palette, demonstrating drawing primitives (rectangles, circles) and palette management.
# Clone the repository
git clone https://github.com/willibrandon/pixel-mcp.git
cd pixel-mcp
# Build the server
make build
Create ~/.config/pixel-mcp/config.json:
{
"aseprite_path": "/path/to/aseprite",
"temp_dir": "/tmp/pixel-mcp",
"timeout": 30,
"log_level": "info",
"log_file": "",
"enable_timing": false
}
Configuration options:
aseprite_path (required): Absolute path to Aseprite executable. No automatic discovery or environment variables.temp_dir (optional): Directory for temporary files. Defaults to /tmp/pixel-mcp.timeout (optional): Command timeout in seconds. Defaults to 30.log_level (optional): Logging verbosity (debug, info, warn, error). Defaults to info.log_file (optional): Path to log file for persistent logging. If empty, logs only to stderr.enable_timing (optional): Enable request tracking and operation timing. Defaults to false.# Run the server (stdio transport)
./bin/pixel-mcp
# Check health
./bin/pixel-mcp --health
# Enable debug logging
./bin/pixel-mcp --debug
Add to your Claude Desktop config:
{
"mcpServers": {
"aseprite": {
"command": "/absolute/path/to/pixel-mcp"
}
}
}
Then use natural language to create sprites:
Note: Selection and clipboard operations persist across MCP tool calls using sprite custom properties (sprite.data) and a hidden clipboard layer. This allows you to create a selection in one tool call, then copy/cut/paste in subsequent calls. Selection bounds are automatically saved and restored, and clipboard content is stored in a hidden __mcp_clipboard__ layer.
See examples/ for a complete working example client that demonstrates all features including canvas creation, animation, dithering, palette management, shading, and antialiasing.
# Build (development - fast, no version info)
make build
# Build release (with version and timestamp)
make release
# Run unit tests
make test
# Run unit tests (no cache)
make test-nocache
# Run integration tests (requires configured Aseprite)
make test-integration
# Run integration tests (no cache)
make test-integration-nocache
# Run benchmarks
make bench
# Run linters
make lint
# Generate coverage report
make test-coverage
# Clean build artifacts
make clean
# Build (development)
go build -o bin/pixel-mcp ./cmd/pixel-mcp
# Build release (with version info)
go build -ldflags "-X main.Version=$(git describe --tags --always --dirty) -X main.BuildTime=$(date -u '+%Y-%m-%d_%H:%M:%S')" -o bin/pixel-mcp ./cmd/pixel-mcp
# Run unit tests
go test -v -race -cover ./...
# Run unit tests (no cache)
go test -v -race -cover -count=1 ./...
# Run integration tests
go test -tags=integration -v ./...
# Run integration tests (no cache)
go test -tags=integration -v -count=1 ./...
# Run benchmarks
go test -tags=integration -bench=. -benchmem ./pkg/aseprite ./pkg/tools
# Run linters
go vet ./...
go fmt ./...
# Generate coverage report
go test -v -race -coverprofile=coverage.txt -covermode=atomic ./...
go tool cover -html=coverage.txt -o coverage.html
All operations complete in under 100ms on typical hardware, with complete workflows finishing in 280-840ms. See docs/BENCHMARKS.md for detailed benchmark results.
MCP server for creating pixel art with Aseprite through AI assistants. Supports animation, retro palettes, dithering, shading, and spritesheet export.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Pixel 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 MCP server for creating pixel art with Aseprite through AI assistants. Supports animation, retro palettes, dithering, shading, and spritesheet export.