LibreSprite MCP
This MCP server lets you control LibreSprite through prompt-assisted scripting by running JavaScript inside the application.
Execute JavaScript scripts inside LibreSprite via the
run_scripttool.Receive console output from executed scripts.
Use MCP resources such as
docs:referenceanddocs:examplesto guide script creation.Connect MCP clients like Claude Desktop or Cursor to LibreSprite using the provided
mcp.jsscript.Support prompt-assisted pixel-art editing, designing, and scripting in LibreSprite.
Enables downloading the required LibreSprite MCP script component from GitHub releases to complete the integration setup.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@LibreSprite MCP create a 32x32 pixel sprite of a smiling cat with green eyes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LibreSprite-MCP
Prompt your way into LibreSprite
Model Context Protocol (MCP) server for prompt-assisted editing, designing, and scripting inside LibreSprite.
https://github.com/user-attachments/assets/71440bba-16a5-4ee2-af10-2c346978a290
Prerequisites
uv is the recommended way to install and use this server. Here are quick one-liners to install it if you haven't:
Windows: (run as administrator)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Unix:
curl -LsSf https://astral.sh/uv/install.sh | sh
More on installing uv.
The package is published on PyPI, so feel free to consume it any other way you prefer (pipx, etc)
Related MCP server: aseprite-mcp
Usage
Step 1: Setting up the client
Add the MCP server with the following entrypoint command (or something else if you are not using uv) to your MCP client:
uvx libresprite-mcpExamples:
Claude Desktop & Cursor
Edit Claude > Settings > Developer > Edit Config > claude_desktop_config.json or .cursor > mcp.json to include the server:
{ "mcpServers": { // ...existing servers... "libresprite": { "type": "stdio", "command": "uvx", "args": [ "libresprite-mcp" ] } // ...existing servers... } }You can also use this fancy badge to make it quick:
You will have to restart Claude Desktop to load the MCP Server.
Step 2: Setting up LibreSprite
Download the latest stable remote script mcp.js from releases and add it to LibreSprite's scripts folder:
![]()
Step 3: Connect and use
Run the mcp.js script (that you see in the screenshot above), and make sure your MCP server is running (Claude Desktop/Cursor is loaded and running). If all went well, you should see the following screen:
![]()
Click the "Connect" button and you can now start talking to Claude about your next big pixel-art project!
Some pointers
You can only run one instance of the MCP server at a time.
The server expects port
64823to be free.Running another script while connected disconnects
mcp.js. Re-runmcp.jsto reconnect.The server has a hacky and brittle implementation (see ARCHITECTURE), and is not extensively tested.
The MCP resources are kinda low quality with unclear API reference and limited examples, leaving the LLM confused at times. If you're a LibreSprite expert, we need your help.
Available Tools
1 toolrun_scriptB
Run a JavaScript script inside Libresprite.
IMPORTANT: Make sure you are well versed with the documentation and examples provided in the resources `docs:reference` and `docs:examples`.
Args:
script: The script to execute
Returns:
Console output
Inputs: script (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity between tools. The singular tool has a clear and distinct purpose.
The single tool name 'run_script' follows a consistent verb_noun pattern. No inconsistencies exist due to the absence of other tools.
The server provides only one tool for a complex domain (LibreSprite pixel art editor). This is too few for typical workflows, which would require multiple tools for editing, layering, and exporting.
The server exposes only a generic script runner, lacking direct tools for common operations like creating, editing, or exporting sprites. While scripting can compensate, the surface is severely incomplete for the stated domain.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Generate authentic pixel art - sprites, animations, and tilesets - from any MCP client
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
Generate, edit, style-match, turn, and animate game-ready pixel art at exact sizes.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for programmatically creating and editing Aseprite sprites, enabling AI agents to draw, manage layers and frames, and iterate until the desired result is achieved.MIT
- AlicenseBqualityDmaintenanceMCP server for Aseprite — create, edit, and export pixel art sprites, animations, and sprite sheets from any AI assistant.438MIT
- AlicenseBqualityBmaintenanceAn MCP server that lets AI agents create and edit Aseprite sprites headlessly, enabling pixel art, animation, and export via 98 tools.15641MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that bridges Antigravity AI with LibreSprite, enabling real-time pixel art drawing, animation, and manipulation through natural language commands.MIT