aseprite-mcp의 개요
GitHub 사용자 giangdvdotdev가 만든 aseprite-mcp는 uvx aseprite-mcp로 실행하는 Python MCP 서버와, Aseprite 1.3 이상 안에서 로드되는 Lua 확장을 짝지은 것입니다. 둘은 127.0.0.1:9876의 WebSocket으로 통신하므로, 에이전트는 뒤에서 파일을 다루는 대신 편집기에 열려 있는 스프라이트를 직접 작업합니다.
활성 스프라이트에 작용하는 도구 30개를 등록합니다. 스프라이트와 레이어 만들기, 픽셀 일괄 그리기, 선, 사각형, 타원, 채우기, 지우기, 캔버스 이미지, 픽 셀, 영역, 레이어, 선택 영역 다시 읽기, 실행 취소와 다시 실행, 프레임 추가, 시간 설정, 삭제, 파일 열기와 저장, PNG와 스프라이트 시트 내보내기입니다. 저장소는 MIT 라이선스이며 스타는 약 13개, 커밋은 5개이고, 0.6.0 버전이 PyPI에 있습니다.
aseprite-mcp 설치 방법
uvx aseprite-mcpaseprite-mcp, 쓸 만한 가치가 있습니까?
aseprite-mcp는 많은 그래픽 서버가 빠뜨리는 한 가지를 제대로 합니다. 에이전트가 자기가 그린 것을 볼 수 있다는 점입니다. get_canvas_image와 픽셀 및 영역 읽기로 모델은 획 사이사이에 스프라이트를 확인할 수 있고, 편집기는 바뀐 내용을 바로 보여 줍니다. 실행 취소와 다시 실행도 도구이므로, 잘못 그린 부분은 사람이 키보드를 만지지 않고도 되돌릴 수 있습니다.
결과물의 수준은 서버가 아니라 모델이 정합니다. README 갤러리에는 Opus 5를 쓴 Claude Code가 그린 개의 걷기 사이클과 사진을 보고 그린 초상화, 그리고 12 GB RTX 3060에서 돌린 로컬 Gemma 4 26B 모델이 그린 고무 오리가 있어, 작은 로컬 모델로도 다룰 수 있다는 좋은 신호입니다. 도구 호출로 그리는 방식은 느리고, 작은 스프라이트를 넘어서면 토큰을 많이 씁니다. 도구 30개 가운데 팔레트나 타일맵을 다루는 것은 없습니다.
README는 보안 입장을 분명히 밝힙니다. WebSocket에는 인증이 없습니다. 127.0.0.1에 바인딩되므로 다른 컴퓨터에서는 닿지 않지만, 서버가 실행되는 동안 같은 컴퓨터의 어떤 프로세스든 Aseprite를 조작할 수 있습니다. export_png, save_sprite, export_spritesheet는 받은 모든 절대 경로 에 쓰고 거기 있던 것을 덮어쓰므로, 혼란에 빠진 에이전트가 프로젝트 밖의 파일을 망가뜨릴 수 있습니다.
한 사람이 만드는 프로젝트로, 공개 기록의 커밋은 5개입니다. 테스트는 서버용 pytest와 플러그인용 Lua 실행기 두 가지이며 Aseprite를 열지 않고도 돌아갑니다. 포트를 협상하는 장치가 없으므로 ASEPRITE_MCP_PORT는 양쪽에서 같아야 합니다. 기본값 9876은 두 Ableton 서버가 쓰는 9877 바로 옆이며, README의 포트 변경 예시는 바로 9877을 골라 둘 중 어느 것과도 충돌하게 됩니다.
제 역할을 하는 곳
2D 플랫폼 게임을 혼자 만드는 개발자
32×32 적 스프라이트와 짧은 걷기 사이클 초안 잡기
스프라이트를 요청한 다음, 시간을 정한 프레임을 더 추가하게 하고, 스프라이트 시트를 게임의 에셋 폴더로 바로 내보냅니다. 모델 비용 말고는 무료이며, 세부는 손으로 다시 칠해야 합니다.
세 명으로 이루어진 게임 잼 팀
다른 사람들이 코드를 짜는 동안 임시 그래픽을 화면에 띄우기
한 사람이 Aseprite에서 에이전트에게 지시하고, 그 초안으로 게임플레이를 시험한 뒤 나중에 바꿉니다. 갤러리의 RTX 3060 예처럼 로컬 모델을 쓰면 API 비용은 0입니다.
픽셀 아트 강사
형태가 픽셀 하나하나로 어떻게 쌓이는지 학생들에게 보여 주기
학생들은 공유 화면에서 에이전트가 그리는 모습을 본 뒤, 실행 취소로 획을 하나씩 되돌리며 손으로 다시 그립니다. 비용은 실행에 쓰는 모델뿐입니다.
도입 전 확인할 점
- 설정
- 클라이언트에 uvx aseprite-mcp를 추가하고, 최신 릴리스의 .aseprite-extension 파일을 설치한 뒤, Aseprite를 다시 시작해 View > Console에 [MCP] Connected.가 뜨는지 확인합니다. 어느 쪽을 먼저 실행해도 되며, 플러그인은 서버가 나타날 때까지 다시 연결을 시도합니다.
- 연동
- Claude Code, Claude Desktop 등 stdio 클라이언트에서 쓸 수 있습니다. 갤러리에 따르면 Pi Agent 같은 에이전트를 통해 로컬 모델도 쓸 수 있습니다. Aseprite 1.3 이상이 필요합니다.
- 데이터와 개인정보
- 모든 것이 로컬에서 실행됩니다. 에이전트가 다시 읽는 캔버스 이미지와 픽셀은 모델 제공업체로 갑니다. 127.0.0.1:9876의 WebSocket에는 인증이 없습니다.
- 제한
- 도구 30개 모두 활성 스프라이트에만 작용하며, 팔레트나 타일맵 도구는 없습니다. ASEPRITE_MCP_PORT는 양쪽에서 같아야 하고, 저장 및 내보내기 도구는 어떤 절대 경로의 파일이든 덮어씁니다.
좋은 점
- 실제 편집기에서 실시간으로 그리며 과정이 보임
- 캔버스 다시 읽기로 모델이 자기 결과를 확인
- 간단한 애니메이션을 위한 프레임과 스프라이트 시트 내보내기
- 갤러리에 따르면 작은 로컬 모델로도 동작
아쉬운 점
- 로컬 WebSocket에 인증이 없음
- 내보내기 도구가 어떤 절대 경로든 덮어씀
- 설치할 구성 요소가 둘이고 포트는 손으로 맞춤
- 관리자 한 명, 스타 약 13개
추천 대상
Aseprite를 쓰는 인디 게임 개발자와 취미 사용자 가운데, 작은 스프라이트와 간단한 애니메이션 사이클의 초안을 에이전트에게 맡기고 마무리는 손으로 하려는 사람에게 맞습니다.
aseprite-mcp 대안
aseprite-mcp: 자주 묻는 질문
- aseprite-mcp, 쓸 만한 가치가 있습니까?
- 에이전트가 실제 편집기에서 스프라이트 초안을 그리고 자기 결과물을 볼 수 있게 해 주는 깔끔한 작 은 다리이지만, 아직 새롭고 범위가 좁아 스케치 보조 이상은 되지 못합니다. 평점은 5점 만점에 3.4점입니다.
- aseprite-mcp의 가격은 얼마입니까?
- 무료 오픈 소스(MIT)입니다. 자신의 Aseprite 1.3 이상이 필요합니다.
- aseprite-mcp의 단점은 무엇입니까?
- 로컬 WebSocket에 인증이 없음; 내보내기 도구가 어떤 절대 경로든 덮어씀; 설치할 구성 요소가 둘이고 포트는 손으로 맞춤; 관리자 한 명, 스타 약 13개.
- aseprite-mcp에 적합한 사람은 누구입니까?
- Aseprite를 쓰는 인디 게임 개발자와 취미 사용자 가운데, 작은 스프라이트와 간단한 애니메이션 사이클의 초안을 에이전트에게 맡기고 마무리는 손으로 하려는 사람에게 맞습니다.
- aseprite-mcp에 회사 데이터를 맡겨도 안전합니까?
- 모든 것이 로컬에서 실행됩니다. 에이전트가 다시 읽는 캔버스 이미지와 픽셀은 모델 제공업체로 갑니다. 127.0.0.1:9876의 WebSocket에는 인증이 없습니다.
- aseprite-mcp의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Photoshop MCP 및 Godot MCP입니다.
답변 확인일: 2026년 11월 14일.