macOS Setup 가이드

강력한 Python MCP (Model Context Protocol) 서버는 향상된 오류 처리, 구성 관리, 일괄 처리 및 더 많은 기능을 갖춘 Aseprite와 프로그래밍 상호 작용을위한 서버!

♨ v2.0에서 새로운 기능

-** Comprehensive️ 종합 오류 처리**: 상세하고, 실행 가능한 오류 메시지와 사용자 정의 예외 -** 설정 관리**: JSON/YAML 지원 Pydantic 기반 설정 -** 고급 로깅**: 성능 메트릭과 구조화된 로깅 -**: 만들기, 적용, 및 추출 색상 팔레트

• : 병렬로 여러 파일 처리 - Lu️ 루아 스크립트 빌더: Clean, type-safe Lua 스크립트 생성
• ** 개선된 보안**: 입력 검증 및 경로 추적 보호 -** Full Full Test Coverage**: 종합 단위 테스트

특징

핵심 그림 공구

• **캔버스 운영 **: 스프라이트 만들기, 레이어 추가 및 프레임 -Drawing Tools: 픽셀, 라인, 직사각형, 원형 및 채우기 작업
• ** 수출 도구**: 사기 및 층 지원과 다양한 형식으로 내보내기

새로운 팔레트 도구 (v2.0)

-Preset Palettes: 게임보이, NES, PICO-8, CGA, 모노크롬, Sepia

Aseprite MCP Tools v2.0

日本語版はこちら | macOS Setup Guide

A powerful Python MCP (Model Context Protocol) server for programmatic interaction with Aseprite, featuring enhanced error handling, configuration management, batch processing, and more!

🚀 What’s New in v2.0

• 🛡️ Comprehensive Error Handling: Custom exceptions with detailed, actionable error messages
• 🔧 Configuration Management: Pydantic-based settings with JSON/YAML support
• 📝 Advanced Logging: Structured logging with performance metrics
• 🎨 Palette Management: Create, apply, and extract color palettes
• ⚡ Batch Processing: Process multiple files in parallel
• 🏗️ Lua Script Builder: Clean, type-safe Lua script generation
• 🔒 Enhanced Security: Input validation and path traversal protection
• 🧪 Full Test Coverage: Comprehensive unit tests

📋 Features

Core Drawing Tools

• Canvas Operations: Create sprites, add layers and frames
• Drawing Tools: Pixels, lines, rectangles, circles, and fill operations
• Export Tools: Export to various formats with scaling and layer support

New Palette Tools (v2.0)

• Preset Palettes: GameBoy, NES, PICO-8, CGA, Monochrome, Sepia
• Custom Palettes: Create and apply custom color schemes
• Palette Extraction: Extract colors from existing images
• Color Remapping: Replace colors throughout sprites

Batch Processing (v2.0)

• Batch Resize: Resize multiple sprites maintaining aspect ratio
• Batch Export: Convert multiple files to different formats
• Batch Palette Apply: Apply palettes to multiple files
• Custom Scripts: Run Lua scripts on file sets

🔧 Installation

Requirements

• Python 3.13+
• Aseprite (must be installed separately)

Claude Desktop Configuration

Using UV (Recommended)

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

Using Python

{
  "mcpServers": {
    "aseprite": {
      "command": "python",
      "args": ["-m", "aseprite_mcp"],
      "cwd": "/path/to/aseprite-mcp",
      "env": {
        "ASEPRITE_PATH": "/path/to/aseprite"
      }
    }
  }
}

Install Dependencies

pip install -r requirements.txt

⚙️ Configuration

Environment Variables

export ASEPRITE_PATH="/Applications/Aseprite.app/Contents/MacOS/aseprite"
export ASEPRITE_MCP_LOG_LEVEL="INFO"

Configuration File (config.json)

{
  "aseprite_path": "/path/to/aseprite",
  "canvas": {
    "max_width": 10000,
    "max_height": 10000
  },
  "batch": {
    "max_parallel_jobs": 4,
    "continue_on_error": true
  },
  "log_level": "INFO",
  "security": {
    "allowed_directories": ["/home/user/sprites"],