aseprite-mcp

Python MCP server for integrating Aseprite with programmable clients

Stars

Forks

Watchers

Issues

Aseprite MCP Tools is a Python module that acts as an MCP (Model Context Protocol) server, providing programmatic access to the Aseprite API. It can be deployed via Docker or locally using Python, and integrates with platforms such as Steam for installing Aseprite. The project enables scripted or automated control over Aseprite by way of the MCP, facilitating advanced workflows such as remote drawing or context-driven tool manipulation.

Key Features

Implements a Model Context Protocol (MCP) server for Aseprite

Provides programmatic access to the Aseprite API

Supports Docker and Docker Compose deployment

Local installation with Python 3.13+ and uv

Automated Aseprite installation via SteamCMD

Ready-to-use build scripts for multiple platforms

Environment-based configuration using .env files

Example configuration for integration with other MCP clients

Facilitates scripted drawing and remote control of Aseprite

Modular design for extension or integration

Use Cases

Automating sprite creation and editing in Aseprite

Integrating Aseprite into custom production pipelines

Remote controlling Aseprite for AI or agent-driven workflows

Scripting complex drawing operations via MCP-compatible clients

Deploying Aseprite automation in cloud or server environments

Batch processing of sprites and graphics assets

Testing tools and plugins for Aseprite via programmable interfaces

Using programmable agents (such as AI models) to interact with graphics editors

Educational setups for teaching tool automation with Aseprite

Integrating Aseprite with CI/CD or asset management systems

README

Aseprite MCP Tools

A Python module that serves as an MCP server for interacting with the Aseprite API

Demo where Cursor draws a cloud in aseprite using the MCP:

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

Docker Usage

Quick Start

Build and run the Docker image:

bash

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

Or use the provided build scripts:

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

Using Docker Compose

bash

# Production
docker-compose up aseprite-mcp

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

See DOCKER.md for detailed Docker setup instructions.

Optional: Install Aseprite via Steam

To have the container install Aseprite via SteamCMD at startup, provide Steam credentials:

powershell

# Create a .env with STEAM_USERNAME/STEAM_PASSWORD (and optional STEAM_GUARD_CODE)
# Then
docker run --rm -i --env-file .env aseprite-mcp:latest

If installed, the binary will be at /opt/steamapps/common/Aseprite/aseprite and ASEPRITE_PATH will be picked up automatically.

Local Installation

Prerequisites

Python 3.13+
uv package manager

Installation:

json

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

Star History

Repository Owner

diivi

User

Repository Details

Language Python

Default Branch main

Size 25 KB

Contributors 2

License MIT License

MCP Verified Sep 2, 2025

Programming Languages

Python

71.33%

Shell

15.86%

Powershell

7.59%

Dockerfile

5.21%

Related MCPs

Discover similar Model Context Protocol servers

awslabs/mcp

Specialized MCP servers for seamless AWS integration in AI and development environments.

AWS MCP Servers is a suite of specialized servers implementing the open Model Context Protocol (MCP) to bridge large language model (LLM) applications with AWS services, tools, and data sources. It provides a standardized way for AI assistants, IDEs, and developer tools to access up-to-date AWS documentation, perform cloud operations, and automate workflows with context-aware intelligence. Featuring a broad catalog of domain-specific servers, quick installation for popular platforms, and both local and remote deployment options, it enhances cloud-native development, infrastructure management, and workflow automation for AI-driven tools. The project includes Docker, Lambda, and direct integration instructions for environments such as Amazon Q CLI, Cursor, Windsurf, Kiro, and VS Code.

⭐ 6,220
MCP
awslabs/mcp

mcp-server-js

Enable secure, AI-driven process automation and code execution on YepCode via Model Context Protocol.

YepCode MCP Server acts as a Model Context Protocol (MCP) server that facilitates seamless communication between AI platforms and YepCode’s workflow automation infrastructure. It allows AI assistants and clients to execute code, manage environment variables, and interact with storage through standardized tools. The server can expose YepCode processes directly as MCP tools and supports both hosted and local installations via NPX or Docker. Enterprise-grade security and real-time interaction make it suitable for integrating advanced automation into AI-powered environments.

⭐ 31
MCP
yepcode/mcp-server-js

mcp-server-templates

Deploy Model Context Protocol servers instantly with zero configuration.

MCP Server Templates enables rapid, zero-configuration deployment of production-ready Model Context Protocol (MCP) servers using Docker containers and a comprehensive CLI tool. It provides a library of ready-made templates for common integrations—including filesystems, GitHub, GitLab, and Zendesk—and features intelligent caching, smart tool discovery, and flexible configuration options via JSON, YAML, environment variables, or CLI. Perfect for AI developers, data scientists, and DevOps teams, it streamlines the process of setting up and managing MCP servers and has evolved into the MCP Platform for enhanced capabilities.

⭐ 5
MCP
Data-Everything/mcp-server-templates

mcpmcp-server

Seamlessly discover, set up, and integrate MCP servers with AI clients.

mcpmcp-server enables users to discover, configure, and connect MCP servers with preferred clients, optimizing AI integration into daily workflows. It supports streamlined setup via JSON configuration, ensuring compatibility with various platforms such as Claude Desktop on macOS. The project simplifies the connection process between AI clients and remote Model Context Protocol servers. Users are directed to an associated homepage for further platform-specific guidance.

⭐ 17
MCP
glenngillen/mcpmcp-server

blender-mcp

Seamless integration between Blender and Claude AI using the Model Context Protocol.

BlenderMCP enables direct interaction between Blender and Claude AI by leveraging the Model Context Protocol (MCP). It allows users to create, manipulate, and inspect 3D scenes in Blender through natural language commands sent to Claude, which communicates with Blender via a custom socket server and an addon. The solution features two-way communication, object and material manipulation, code execution within Blender, and easy integration with tools like Cursor, Visual Studio Code, and Claude for Desktop.

⭐ 13,092
MCP
ahujasid/blender-mcp

manim-mcp-server

MCP server for generating Manim animations on demand.

Manim MCP Server allows users to execute Manim Python scripts via a standardized protocol, generating animation videos that are returned as output. It integrates with systems like Claude to dynamically render animation content from user scripts and supports configurable deployment using environment variables. The server handles management of output files and cleanup of temporary resources, designed with portability and ease of integration in mind.

⭐ 454
MCP
abhiemj/manim-mcp-server

View all Alternatives

Didn't find tool you were looking for?

Search AI Tools