zcube/penpot-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

20 stars 8 forks 품질 65 트렌드 14

Repository Install

MCP server for Penpot - Connect AI assistants to Penpot design platform via Model Context Protocol

개요

A Model Context Protocol (MCP) server that provides full manipulation capabilities for Penpot - the open-source design tool. This server enables AI assistants to create, modify, and manage Penpot designs programmatically, similar to Figma plugin capabilities. Example chat interface created entirely through natural conversation with an AI assistant using this MCP server. See Example 7: Chat Interface for the complete conversation that generated this design. The screenshot above demonstrates how you can describe a design in natural language, and the AI assistant will create it in Penpot using the MCP server's capabilities - handling layout, styling, components, and interactions automatically.

README

원문 README의 일부입니다. 원문 보기.

Penpot MCP Server

🐳 Multi-architecture Docker images available: linux/amd64, linux/arm64

🎬 See It In Action

Example chat interface created entirely through natural conversation with an AI assistant using this MCP server. See Example 7: Chat Interface for the complete conversation that generated this design.

The screenshot above demonstrates how you can describe a design in natural language, and the AI assistant will create it in Penpot using the MCP server’s capabilities - handling layout, styling, components, and interactions automatically.

Features

🎨 Complete Design Manipulation

Create & Manage Files: Create new design files, list projects, and manage file metadata
Shape Operations: Create rectangles, circles, frames, paths, text, and SVG shapes
Modify Designs: Update shape properties, move objects, resize, rotate, and style
Page Management: Add, remove, and organize pages within files
Component System: Create and manage reusable components

🔄 Real-time Operations

Direct API integration with Penpot
Session-based updates with revision tracking
Support for batch operations

🛠️ Available Tools (76+ Tools!)

Project & File Management (8 tools)

list_teams - List all accessible teams
list_projects - List all accessible projects
list_files - List files in a project
get_file - Get file data and structure
create_file - Create a new design file
rename_file - Rename an existing file
delete_file - Delete a file permanently

Page Management (8 tools)

list_pages - List all pages in a file
add_page - Add a new page to a file
get_page_shapes - Get all shapes on a specific page (basic info)
query_shapes - Query and filter shapes with criteria (like grep). Filter by type, area, color, font, text content. Select fields to return. Useful for bulk operations
get_shape_properties - Get detailed properties of a specific shape (colors, text, fonts, effects, etc.)
rename_page - Rename a page
delete_page - Delete a page from a file
move_shapes - Move shapes to different parent/frame or reorder

Shape Creation (6 tools)

create_rectangle - Create rectangle shapes
create_circle - Create circle/ellipse shapes

GitHub에서 전체 README 보기

설치

npx penpot-mcp-server

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "penpot": {
      "command": "node",
      "args": ["/path/to/penpot-mcp-server/dist/index.js"],
      "env": {
        "PENPOT_API_URL": "https://design.penpot.app",
        "PENPOT_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}