LibreSprite

Prompt your way into LibreSprite.

javascript

13

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "snehil-shah-libresprite-mcp": {
      "command": "uvx",
      "args": [
        "libresprite-mcp"
      ]
    }
  }
}

This MCP server enables prompt-assisted editing, designing, and scripting inside LibreSprite by linking LibreSprite with a prompt-driven client. It lets you converse with an assistant to plan and execute pixel-art projects right inside your editing workflow.

How to use

You connect your MCP client to the LibreSprite MCP server and then chat with your assistant to guide your pixel-art workflow. After starting the server and LibreSprite with the prompt script, you’ll see a Connect option in your client interface. Click Connect to begin discussing your next project and to have the assistant help you draft, edit, and prototype designs inside LibreSprite.

How to install

Prerequisites: you need a runtime that can launch MCP servers. The recommended tool is uv, which can run local MCP servers and handle their lifecycle for you.

Install uv if you don’t have it yet. Run one of the following commands depending on your operating system.

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

curl -LsSf https://astral.sh/uv/install.sh | sh

MCP server setup for LibreSprite

Next, add the MCP server entry to your client configuration so it can start and connect to the local server. You will use the stdio-based configuration that runs a local command via uvx.

Use the following snippet in your client configuration to register the LibreSprite MCP server. This uses a local stdio server that runs uvx with the libresprite-mcp entry.

{
  "mcpServers": {
    "libresprite": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "libresprite-mcp"
      ]
    }
  }
}

Connect and use

With LibreSprite installed and the MCP server configured, run the following steps to connect.

Start the MCP server by launching the stdio command via your MCP client (the configuration above uses uvx). Ensure the server process is running and LibreSprite is ready.
In your MCP client, locate the Libresprite MCP entry and press Connect. The assistant will begin listening for prompts about your pixel-art project.

Notes and tips

You can run only one MCP server instance at a time. Make sure no other LibreSprite MCP server is occupying the same runtime. - The standard port expectation is that the server uses a local runtime and communicates over the local process channel.
The integration may be brittle or experimental. If you encounter issues, restart the editing environment and re-establish the connection.