Aseprite MCP 工具

一个Python模块，作为与Aseprite API交互的MCP服务器

演示中，Cursor使用MCP在Aseprite中绘制云朵：

https://github.com/user-attachments/assets/572edf75-ab66-4700-87ee-d7d3d196c597

Docker 使用

快速开始

构建并运行Docker镜像：

docker build -t aseprite-mcp:latest .
docker run -it --rm aseprite-mcp:latest

或者使用提供的构建脚本：

• Linux/macOS: chmod +x build-docker.sh && ./build-docker.sh
• Windows: .\build-docker.ps1

使用Docker Compose

# 生产环境
docker-compose up aseprite-mcp

# 开发模式
docker-compose --profile dev up aseprite-mcp-dev

详情请参阅DOCKER.md以获取详细的Docker设置说明。

可选：通过Steam安装Aseprite

为了让容器在启动时通过SteamCMD安装Aseprite，请提供Steam凭证：

# 创建一个包含STEAM_USERNAME/STEAM_PASSWORD（以及可选的STEAM_GUARD_CODE）的.env文件
# 然后
docker run --rm -i --env-file .env aseprite-mcp:latest

如果已安装，二进制文件将在/opt/steamapps/common/Aseprite/aseprite，并且ASEPRITE_PATH将被自动识别。

本地安装

预备条件

• Python 3.13+
• uv 包管理器

安装：

{
  "mcpServers": {
      "aseprite": {
          "command": "/opt/homebrew/bin/uv",
          "args": [
              "--directory",
              "/path/to/repo",
              "run",
              "-m",
              "aseprite_mcp"
          ]
      }
  }
}