Aseprite MCP Araçları

Aseprite API ile etkileşim kurmak için MCP sunucusu olarak hizmet veren bir Python modülü

Cursor'un MCP kullanarak Aseprite'da bulut çizdiği demo:

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

Docker Kullanımı

Hızlı Başlangıç

Docker image'ını derleyin ve çalıştırın:

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

Veya sağlanan build scriptlerini kullanın:

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

Docker Compose Kullanımı

# Production
docker-compose up aseprite-mcp

# Development modu
docker-compose --profile dev up aseprite-mcp-dev

Detaylı Docker kurulum talimatları için DOCKER.md dosyasını inceleyin.

İsteğe Bağlı: Steam Üzerinden Aseprite Kurulumu

Konteyner'in başlatılması sırasında Aseprite'ı SteamCMD aracılığıyla kurmak için Steam kimlik bilgilerini sağlayın:

# STEAM_USERNAME/STEAM_PASSWORD (ve isteğe bağlı STEAM_GUARD_CODE) içeren bir .env dosyası oluşturun
# Ardından
docker run --rm -i --env-file .env aseprite-mcp:latest

Kurulduysa, binary /opt/steamapps/common/Aseprite/aseprite konumunda olacak ve ASEPRITE_PATH otomatik olarak algılanacaktır.

Yerel Kurulum

Ön Koşullar

• Python 3.13+
• uv paket yöneticisi

Kurulum:

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