Piskel MCP Server

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

Bird Animation Heart Sword Treasure Chest Explosion

功能特点

创建和管理像素画项目
绘制像素、线条、矩形、圆形
洪水填充工具
图层管理
导出为 PNG、GIF 和雪碧图
动画帧支持

安装

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。

MCP Servers