Configure pixel-mcp server and verify Aseprite installation
Configures pixel-mcp server and verifies Aseprite installation with auto-detection
/plugin marketplace add willibrandon/pixel-plugin/plugin install pixel-plugin@pixel-pluginaseprite-pathConfigure the pixel-mcp server and verify Aseprite installation.
/pixel-setup [aseprite-path]
aseprite-path (optional): Path to Aseprite executable
Detects Aseprite installation
/Applications/Aseprite.app/Contents/MacOS/aseprite/usr/bin/aseprite, /usr/local/bin/asepriteC:\Program Files\Aseprite\Aseprite.exeCreates configuration file
~/.config/pixel-mcp/config.json (macOS/Linux)%APPDATA%\pixel-mcp\config.json (Windows)aseprite_path in configurationValidates configuration
Tests MCP server
/pixel-setup
→ Auto-detects Aseprite installation and configures
/pixel-setup /Applications/Aseprite.app/Contents/MacOS/aseprite
→ Uses specified path for macOS
/pixel-setup "C:\Program Files\Aseprite\Aseprite.exe"
→ Uses specified path for Windows
/pixel-setup /usr/local/bin/aseprite
→ Uses specified path for Linux
macOS:
/Applications/Aseprite.app/Contents/MacOS/aseprite$HOME/Applications/Aseprite.app/Contents/MacOS/aseprite/usr/local/bin/aseprite$HOME/.local/bin/asepriteLinux:
/usr/bin/aseprite/usr/local/bin/aseprite$HOME/.local/bin/aseprite$HOME/bin/aseprite/opt/aseprite/bin/aseprite/snap/bin/asepriteWindows:
C:\Program Files\Aseprite\Aseprite.exeC:\Program Files (x86)\Aseprite\Aseprite.exe%LOCALAPPDATA%\Aseprite\Aseprite.exe%USERPROFILE%\AppData\Local\Aseprite\Aseprite.exeLocation:
~/.config/pixel-mcp/config.json%APPDATA%\pixel-mcp\config.jsonContents:
{
"aseprite_path": "/path/to/aseprite",
"temp_dir": "/tmp/pixel-mcp",
"timeout": 30,
"log_level": "info",
"log_file": "",
"enable_timing": false
}
Required Field:
aseprite_path: Path to Aseprite executable (only required field)Optional Fields:
temp_dir: Temporary directory for MCP operations (default: system temp)timeout: Command timeout in seconds (default: 30)log_level: Logging level: "debug", "info", "warn", "error" (default: "info")log_file: Path to log file (default: "" = no file logging)enable_timing: Log operation timings for performance analysis (default: false)Step 1: Auto-Detection
config/detect-aseprite.shStep 2: Validate Path
aseprite --version to verifyStep 3: Create Configuration
mkdir -p ~/.config/pixel-mcpStep 4: Test MCP Server
${CLAUDE_PLUGIN_ROOT}/bin/pixel-mcp --healthStep 5: Report Results
✓ Aseprite detected at: /Applications/Aseprite.app/Contents/MacOS/aseprite
✓ Configuration created: ~/.config/pixel-mcp/config.json
✓ Aseprite version: v1.3.2
✓ MCP server ready
Plugin setup complete! You can now create pixel art with commands like:
/pixel-new
/pixel-palette set nes
Aseprite not found:
✗ Aseprite not found in common installation paths
Please install Aseprite from: https://www.aseprite.org/
Or specify the path manually: /pixel-setup /path/to/aseprite
Invalid path provided:
✗ Aseprite not found at: /invalid/path
Please check the path and try again, or run /pixel-setup without arguments for auto-detection.
Permission errors:
✗ Cannot create configuration directory: ~/.config/pixel-mcp
Permission denied
Please check directory permissions or run with appropriate privileges.
MCP server health check failed:
✗ MCP server health check failed
Error: [error details]
Please check that:
1. Aseprite path is correct
2. Aseprite is executable
3. pixel-mcp binary has execute permissions
Include in output if errors occur:
chmod +x ${CLAUDE_PLUGIN_ROOT}/bin/pixel-mcp~/.config/pixel-mcp/config.jsonaseprite --version in terminallog_file in config for debuggingmacOS:
Linux:
Windows:
For development:
log_level to "debug" for detailed outputlog_file to save logs for troubleshootingenable_timing to see operation performanceFor production:
log_level at "info" (default)log_file empty unless debuggingenable_timing (default)For slow systems:
timeout to 60 or more secondsOnce setup is complete:
Create your first sprite:
/pixel-new 64x64
Try natural language:
"Create a 32x32 pixel art character"
Explore palette presets:
/pixel-palette set nes
Export your work:
/pixel-export png sprite.png scale=4
Get help:
/pixel-help