Skip to main content
Glama

Piskel MCP Server

CI License

Piskel 像素画编辑器的 MCP(Model Context Protocol)服务器,让 AI 助手能够通过 MCP 协议创建和操作像素画。

English | 简体中文

功能特点

  • 创建和管理像素画项目

  • 绘制像素、线条、矩形、圆形

  • 洪水填充工具

  • 图层管理

  • 导出为 PNG、GIF 和雪碧图

  • 动画帧支持

Related MCP server: Pixel Art AI

安装

git clone https://github.com/yafeiaa/piskel-mcp-server.git
cd piskel-mcp-server
npm install
npm run build

快速开始

接入 Agent

服务器使用 stdio 传输协议。将以下配置添加到你的 Agent 设置中:

{
  "mcpServers": {
    "piskel": {
      "command": "node",
      "args": ["/path/to/piskel-mcp-server/dist/index.js"]
    }
  }
}

请将 /path/to/piskel-mcp-server/ 替换为你实际的克隆路径。

开始创作!

连接后,你可以用自然语言创建像素画:

"创建一个 32x32 的红色爱心精灵图"
"在中心画一个蓝色圆形"
"用绿色填充左半边"
"导出为动画 GIF"

MCP 工具

项目管理

  • piskel_create_project - 创建新像素画项目

  • piskel_list_projects - 列出所有项目

  • piskel_get_project_info - 获取项目详情

  • piskel_delete_project - 删除项目

图层管理

  • piskel_add_layer - 添加新图层

  • piskel_remove_layer - 移除图层

帧管理

  • piskel_add_frame - 添加新帧

  • piskel_remove_frame - 移除帧

  • piskel_duplicate_frame - 复制帧

绘图工具

  • piskel_draw_pixel - 绘制单个像素

  • piskel_draw_pixels - 绘制多个像素

  • piskel_draw_line - 绘制线条

  • piskel_draw_rectangle - 绘制矩形

  • piskel_draw_circle - 绘制圆形

  • piskel_fill_area - 洪水填充

  • piskel_erase_pixel - 擦除像素

  • piskel_clear_frame - 清空帧

数据读取

  • piskel_get_pixel - 获取像素颜色

  • piskel_get_frame_data - 获取帧像素数据

导出

  • piskel_export_png - 导出为 PNG

  • piskel_export_gif - 导出为 GIF

  • piskel_export_sprite_sheet - 导出为雪碧图

贡献指南

开发和 Pull Request 规范请查看 CONTRIBUTING.md。

许可证

Apache-2.0

致谢

基于 Julian Descottes 创建的 Piskel。

Available Tools

22 tools
add_frameC

Add a new frame to a layer

Inputs: projectId (required), layerIndex.

add_layerC

Add a new layer to the project

Inputs: projectId (required), layerName.

clear_frameC

Clear all pixels in a frame

Inputs: projectId (required), layerIndex, frameIndex.

create_projectC

Create a new pixel art project

Inputs: projectId (required), width (required), height (required), name.

delete_projectC

Delete a project

Inputs: projectId (required).

draw_circleC

Draw a circle/ellipse (outline or filled)

Inputs: projectId (required), x0 (required), y0 (required), x1 (required), +6 more.

draw_lineC

Draw a line between two points

Inputs: projectId (required), x0 (required), y0 (required), x1 (required), +5 more.

draw_pixelC

Draw a single pixel

Inputs: projectId (required), x (required), y (required), color (required), +2 more.

draw_pixelsC

Draw multiple pixels at once

Inputs: projectId (required), pixels (required), color (required), layerIndex, +1 more.

draw_rectangleC

Draw a rectangle (outline or filled)

Inputs: projectId (required), x0 (required), y0 (required), x1 (required), +6 more.

duplicate_frameC

Duplicate a frame

Inputs: projectId (required), frameIndex (required).

erase_pixelC

Erase pixels (set to transparent)

Inputs: projectId (required), x (required), y (required), layerIndex, +2 more.

export_gifC

Export as animated GIF

Inputs: projectId (required), outputPath (required), frameDelay.

export_pngC

Export a frame as PNG

Inputs: projectId (required), outputPath (required), frameIndex.

export_sprite_sheetC

Export all frames as a sprite sheet PNG

Inputs: projectId (required), outputPath (required), columns.

fill_areaB

Fill a connected area with a color (paint bucket)

Inputs: projectId (required), x (required), y (required), color (required), +2 more.

get_frame_dataB

Get all pixel data from a frame as a 2D array

Inputs: projectId (required), layerIndex, frameIndex.

get_pixelC

Get the color of a pixel

Inputs: projectId (required), x (required), y (required), layerIndex, +1 more.

get_project_infoC

Get information about a project

Inputs: projectId (required).

list_projectsB

List all active projects

Inputs: no named parameters.

remove_frameC

Remove a frame from all layers

Inputs: projectId (required), frameIndex (required).

remove_layerC

Remove a layer from the project

Inputs: projectId (required), layerIndex (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 22 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no significant overlap. Drawing tools (draw_circle, draw_line, draw_pixel, draw_pixels, draw_rectangle, fill_area) target specific shapes, while project management (create_project, delete_project, list_projects), layer/frame operations (add_layer, remove_layer, add_frame, duplicate_frame, remove_frame, clear_frame), and export functions (export_gif, export_png, export_sprite_sheet) are well-separated. The data retrieval tools (get_frame_data, get_pixel, get_project_info) also serve unique roles.

    Naming Consistency5/5

    Tool names follow a consistent verb_noun pattern throughout, using snake_case exclusively. All names clearly indicate the action (add, create, delete, draw, duplicate, erase, export, get, list, remove) followed by the target object, making them predictable and readable. There are no deviations in naming conventions.

    Tool Count4/5

    With 22 tools, the count is slightly high but reasonable for a pixel art editor covering project management, drawing, layer/frame manipulation, export, and data retrieval. It feels comprehensive rather than bloated, though it borders on the upper limit of typical scoping (3-15 tools). Each tool appears to earn its place without obvious redundancy.

    Completeness5/5

    The tool set provides complete coverage for a pixel art editor domain. It includes project CRUD (create, delete, list, get info), drawing operations (various shapes and tools), layer and frame management (add, remove, duplicate, clear), export formats (GIF, PNG, sprite sheet), and data access (pixel and frame data). There are no apparent gaps that would hinder agent workflows for core pixel art creation and editing tasks.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables LLMs to create and edit pixel art reliably with support for layers, frames, symmetry, and various drawing tools.
      70
      MIT No Attribution
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI coding agents to create, draw, and refine Aseprite documents through deterministic canvas, layer, frame, tag, and palette tools, with pixel analyzers, style validation, and preview/diff visual feedback. It also supports spritesheet and animated GIF export, producing multi-layer game-ready assets.
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to create and edit pixel art and animated sprites in Aseprite through 104 tools covering drawing, layers, animation, palettes, tilemaps, exports, visual analysis, and raw Lua scripting.
      116
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables an AI agent to create and edit pixel art directly in Aseprite — building sprites, layers, frames, animation tags and palettes, painting pixels and primitives, inspecting the rendered result, and exporting GIFs or sprite sheets. All work lands on real .aseprite files that can be opened and edited by hand.
      43
      1
      MIT