Piskel MCP Server
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., "@Piskel MCP Server Create a 32x32 red heart animation and export it as a GIF"
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.
Piskel MCP Server
Piskel 像素画编辑器的 MCP(Model Context Protocol)服务器,让 AI 助手能够通过 MCP 协议创建和操作像素画。
功能特点
创建和管理像素画项目
绘制像素、线条、矩形、圆形
洪水填充工具
图层管理
导出为 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- 导出为 PNGpiskel_export_gif- 导出为 GIFpiskel_export_sprite_sheet- 导出为雪碧图
贡献指南
开发和 Pull Request 规范请查看 CONTRIBUTING.md。
许可证
Apache-2.0
致谢
基于 Julian Descottes 创建的 Piskel。
Available Tools
22 toolsadd_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
Scored across 22 tools
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.
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.
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.
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
Related MCP Connectors
Generate, edit, style-match, turn, and animate game-ready pixel art at exact sizes.
Pixel art for your game, from your coding agent. Generate sprites, items and tiles in your game's style (64 to 1024 px), make variants, reskins and N/E/S/W directions, then edit everything in a full pixel art editor that syncs into your project. Works with Claude, Claude Code, Cursor and ChatGPT; sign in with OAuth, no API key.
Turn images into pixel art, extract and remap palettes, and upscale sprites without blur.
Generate pixel art sprites, animations, 8-direction rotations and palettes for games.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables LLMs to create and edit pixel art reliably with support for layers, frames, symmetry, and various drawing tools.70MIT No Attribution
- AlicenseNot gradedqualityCmaintenanceEnables 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.1MIT
- AlicenseBqualityCmaintenanceEnables 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.116MIT
- AlicenseBqualityCmaintenanceEnables 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.431MIT