Content
# Aseprite MCP Server
A Model Context Protocol (MCP) server for Aseprite.
## Features
- **Procedural Script Execution:** Run custom Lua scripts to programmatically draw and manipulate sprites inside Aseprite.
- **Semantic Tools:** Add animations, draw assets (grass, stone), and create projects.
- **Visual Feedback:** Most drawing operations return a PNG preview to the LLM.
- **Security:** Temporary Lua scripts are safely execution-bound and cleaned up.
## Setup
1. Install [Aseprite](https://www.aseprite.org/).
2. Clone this repo and install dependencies:
```bash
pnpm install
pnpm run build
```
3. (Optional) Copy `.env.example` to `.env` and set `ASEPRITE_PATH` if it's not in your system PATH.
## Usage with Claude Desktop
Add the following to your Claude Desktop config:
```json
{
"mcpServers": {
"aseprite": {
"command": "node",
"args": ["/path/to/aseprite_mcp/dist/index.js"],
"env": {
"ASEPRITE_PATH": "aseprite"
}
}
}
}
```
## Security Note
- Never commit your `.env` file.
- Temporary Lua scripts are automatically cleaned up after execution.
An MCP to integrated LLMs with Aesprite
