Aseprite MCP Tools

1# Aseprite MCP Tools
2 
3A Python module that serves as an MCP server for interacting with the Aseprite API
4 
5Demo where Cursor draws a cloud in aseprite using the MCP:
6 
7https://github.com/user-attachments/assets/572edf75-ab66-4700-87ee-d7d3d196c597
8 
9## Docker Usage
10 
11### Quick Start
12 
13Build and run the Docker image:
14```bash
15docker build -t aseprite-mcp:latest .
16docker run -it --rm aseprite-mcp:latest
17```
18 
19Or use the provided build scripts:
20- **Linux/macOS**: `chmod +x build-docker.sh && ./build-docker.sh`
21- **Windows**: `.\build-docker.ps1`
22 
23### Using Docker Compose
24```bash
25# Production
26docker-compose up aseprite-mcp
27 
28# Development mode
29docker-compose --profile dev up aseprite-mcp-dev
30```
31 
32See [DOCKER.md](DOCKER.md) for detailed Docker setup instructions.
33 
34### Optional: Install Aseprite via Steam
35 
36To have the container install Aseprite via SteamCMD at startup, provide Steam credentials:
37 
38```powershell
39# Create a .env with STEAM_USERNAME/STEAM_PASSWORD (and optional STEAM_GUARD_CODE)
40# Then
41docker run --rm -i --env-file .env aseprite-mcp:latest
42```
43 
44If installed, the binary will be at `/opt/steamapps/common/Aseprite/aseprite` and `ASEPRITE_PATH` will be picked up automatically.
45 
46## Local Installation
47 
48### Prerequisites
49- Python 3.13+
50- `uv` package manager
51 
52### Installation:
53```json
54{
55  "mcpServers": {
56      "aseprite": {
57          "command": "/opt/homebrew/bin/uv",
58          "args": [
59              "--directory",
60              "/path/to/repo",
61              "run",
62              "-m",
63              "aseprite_mcp"
64          ]
65      }
66  }
67}
68```
69