mcp server gestartet
Some checks failed
CI / test (3.10) (push) Has been cancelled
CI / test (3.11) (push) Has been cancelled
CI / test (3.12) (push) Has been cancelled
CI / test (3.13) (push) Has been cancelled
CI / security-check (push) Has been cancelled
CI / build-test (push) Has been cancelled
CI / test-docker (push) Has been cancelled
Publish to PyPI / check-tests (push) Has been cancelled
Publish to PyPI / publish-release (push) Has been cancelled
Publish to PyPI / publish (push) Has been cancelled
Code Quality / code-quality (push) Has been cancelled
Some checks failed
CI / test (3.10) (push) Has been cancelled
CI / test (3.11) (push) Has been cancelled
CI / test (3.12) (push) Has been cancelled
CI / test (3.13) (push) Has been cancelled
CI / security-check (push) Has been cancelled
CI / build-test (push) Has been cancelled
CI / test-docker (push) Has been cancelled
Publish to PyPI / check-tests (push) Has been cancelled
Publish to PyPI / publish-release (push) Has been cancelled
Publish to PyPI / publish (push) Has been cancelled
Code Quality / code-quality (push) Has been cancelled
This commit is contained in:
10
.env
Normal file
10
.env
Normal file
@@ -0,0 +1,10 @@
|
|||||||
|
# ✅ Penpot Login-Daten (von deinem Penpot-Server)
|
||||||
|
PENPOT_USERNAME=dein_benutzername
|
||||||
|
PENPOT_PASSWORD=dein_passwort
|
||||||
|
|
||||||
|
# ✅ Server-Konfiguration für den MCP Server
|
||||||
|
PORT=5000
|
||||||
|
DEBUG=true
|
||||||
|
|
||||||
|
# ✅ API URL deiner lokalen Penpot-Instanz
|
||||||
|
PENPOT_API_URL=http://192.168.10.102:9010/api
|
||||||
2
.gitignore
vendored
2
.gitignore
vendored
@@ -30,7 +30,7 @@ env/
|
|||||||
.python-version
|
.python-version
|
||||||
|
|
||||||
# Environment variables
|
# Environment variables
|
||||||
.env
|
#.env
|
||||||
|
|
||||||
# IDE files
|
# IDE files
|
||||||
.idea/
|
.idea/
|
||||||
|
|||||||
14
README.md
14
README.md
@@ -1,5 +1,6 @@
|
|||||||
# Penpot MCP Server 🎨🤖
|
# Penpot MCP Server 🎨🤖
|
||||||
|
|
||||||
|
<!-- git test -->
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="images/penpot-mcp.png" alt="Penpot MCP Logo" width="400"/>
|
<img src="images/penpot-mcp.png" alt="Penpot MCP Logo" width="400"/>
|
||||||
</p>
|
</p>
|
||||||
@@ -47,6 +48,7 @@ Check out our demo video to see Penpot MCP in action:
|
|||||||
## ✨ Features
|
## ✨ Features
|
||||||
|
|
||||||
### 🔌 Core Capabilities
|
### 🔌 Core Capabilities
|
||||||
|
|
||||||
- **MCP Protocol Implementation**: Full compliance with Model Context Protocol standards
|
- **MCP Protocol Implementation**: Full compliance with Model Context Protocol standards
|
||||||
- **Real-time Design Access**: Direct integration with Penpot's API for live design data
|
- **Real-time Design Access**: Direct integration with Penpot's API for live design data
|
||||||
- **Component Analysis**: AI-powered analysis of design components and layouts
|
- **Component Analysis**: AI-powered analysis of design components and layouts
|
||||||
@@ -54,12 +56,14 @@ Check out our demo video to see Penpot MCP in action:
|
|||||||
- **Design Validation**: Automated design system compliance checking
|
- **Design Validation**: Automated design system compliance checking
|
||||||
|
|
||||||
### 🛠️ Developer Tools
|
### 🛠️ Developer Tools
|
||||||
|
|
||||||
- **Command-line Utilities**: Powerful CLI tools for design file analysis and validation
|
- **Command-line Utilities**: Powerful CLI tools for design file analysis and validation
|
||||||
- **Python SDK**: Comprehensive Python library for custom integrations
|
- **Python SDK**: Comprehensive Python library for custom integrations
|
||||||
- **REST API**: HTTP endpoints for web application integration
|
- **REST API**: HTTP endpoints for web application integration
|
||||||
- **Extensible Architecture**: Plugin system for custom AI workflows
|
- **Extensible Architecture**: Plugin system for custom AI workflows
|
||||||
|
|
||||||
### 🎨 AI Integration Features
|
### 🎨 AI Integration Features
|
||||||
|
|
||||||
- **Claude Desktop & Cursor Integration**: Native support for Claude AI assistant in both Claude Desktop and Cursor IDE
|
- **Claude Desktop & Cursor Integration**: Native support for Claude AI assistant in both Claude Desktop and Cursor IDE
|
||||||
- **Design Context Sharing**: Provide design context to AI models for better responses
|
- **Design Context Sharing**: Provide design context to AI models for better responses
|
||||||
- **Visual Component Recognition**: AI can "see" and understand design components
|
- **Visual Component Recognition**: AI can "see" and understand design components
|
||||||
@@ -69,18 +73,21 @@ Check out our demo video to see Penpot MCP in action:
|
|||||||
## 💡 Use Cases
|
## 💡 Use Cases
|
||||||
|
|
||||||
### For Designers
|
### For Designers
|
||||||
|
|
||||||
- **Design Review Automation**: Get instant AI feedback on accessibility, usability, and design principles
|
- **Design Review Automation**: Get instant AI feedback on accessibility, usability, and design principles
|
||||||
- **Component Documentation**: Automatically generate documentation for design systems
|
- **Component Documentation**: Automatically generate documentation for design systems
|
||||||
- **Design Consistency Checks**: Ensure brand guidelines compliance across projects
|
- **Design Consistency Checks**: Ensure brand guidelines compliance across projects
|
||||||
- **Asset Organization**: AI-powered tagging and categorization of design components
|
- **Asset Organization**: AI-powered tagging and categorization of design components
|
||||||
|
|
||||||
### For Developers
|
### For Developers
|
||||||
|
|
||||||
- **Design-to-Code Workflows**: Bridge the gap between design and development with AI assistance
|
- **Design-to-Code Workflows**: Bridge the gap between design and development with AI assistance
|
||||||
- **API Integration**: Programmatic access to design data for custom tools and workflows
|
- **API Integration**: Programmatic access to design data for custom tools and workflows
|
||||||
- **Automated Testing**: Generate visual regression tests from design specifications
|
- **Automated Testing**: Generate visual regression tests from design specifications
|
||||||
- **Design System Sync**: Keep design tokens and code components in sync
|
- **Design System Sync**: Keep design tokens and code components in sync
|
||||||
|
|
||||||
### For Product Teams
|
### For Product Teams
|
||||||
|
|
||||||
- **Design Analytics**: Track design system adoption and component usage
|
- **Design Analytics**: Track design system adoption and component usage
|
||||||
- **Collaboration Enhancement**: AI-powered design reviews and feedback collection
|
- **Collaboration Enhancement**: AI-powered design reviews and feedback collection
|
||||||
- **Workflow Optimization**: Automate repetitive design operations and approvals
|
- **Workflow Optimization**: Automate repetitive design operations and approvals
|
||||||
@@ -152,6 +159,7 @@ DEBUG=true
|
|||||||
```
|
```
|
||||||
|
|
||||||
> **⚠️ CloudFlare Protection Notice**: The Penpot cloud site (penpot.app) uses CloudFlare protection that may occasionally block API requests. If you encounter authentication errors or blocked requests:
|
> **⚠️ CloudFlare Protection Notice**: The Penpot cloud site (penpot.app) uses CloudFlare protection that may occasionally block API requests. If you encounter authentication errors or blocked requests:
|
||||||
|
>
|
||||||
> 1. Open your web browser and navigate to [https://design.penpot.app](https://design.penpot.app)
|
> 1. Open your web browser and navigate to [https://design.penpot.app](https://design.penpot.app)
|
||||||
> 2. Log in to your Penpot account
|
> 2. Log in to your Penpot account
|
||||||
> 3. Complete any CloudFlare human verification challenges if prompted
|
> 3. Complete any CloudFlare human verification challenges if prompted
|
||||||
@@ -246,6 +254,7 @@ penpot-client
|
|||||||
## MCP Resources & Tools
|
## MCP Resources & Tools
|
||||||
|
|
||||||
### Resources
|
### Resources
|
||||||
|
|
||||||
- `server://info` - Server status and information
|
- `server://info` - Server status and information
|
||||||
- `penpot://schema` - Penpot API schema as JSON
|
- `penpot://schema` - Penpot API schema as JSON
|
||||||
- `penpot://tree-schema` - Penpot object tree schema as JSON
|
- `penpot://tree-schema` - Penpot object tree schema as JSON
|
||||||
@@ -253,6 +262,7 @@ penpot-client
|
|||||||
- `penpot://cached-files` - List of cached Penpot files
|
- `penpot://cached-files` - List of cached Penpot files
|
||||||
|
|
||||||
### Tools
|
### Tools
|
||||||
|
|
||||||
- `list_projects` - List all Penpot projects
|
- `list_projects` - List all Penpot projects
|
||||||
- `get_project_files` - Get files for a specific project
|
- `get_project_files` - Get files for a specific project
|
||||||
- `get_file` - Retrieve a Penpot file by its ID and cache it
|
- `get_file` - Retrieve a Penpot file by its ID and cache it
|
||||||
@@ -291,6 +301,7 @@ Add the following configuration to your Claude Desktop config file (`~/Library/A
|
|||||||
Cursor IDE supports MCP servers through its AI integration features. To configure Penpot MCP with Cursor:
|
Cursor IDE supports MCP servers through its AI integration features. To configure Penpot MCP with Cursor:
|
||||||
|
|
||||||
1. **Install the MCP server** (if not already installed):
|
1. **Install the MCP server** (if not already installed):
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install penpot-mcp
|
pip install penpot-mcp
|
||||||
```
|
```
|
||||||
@@ -314,6 +325,7 @@ Cursor IDE supports MCP servers through its AI integration features. To configur
|
|||||||
```
|
```
|
||||||
|
|
||||||
3. **Alternative: Use environment variables** by creating a `.env` file in your project root:
|
3. **Alternative: Use environment variables** by creating a `.env` file in your project root:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
PENPOT_API_URL=https://design.penpot.app/api
|
PENPOT_API_URL=https://design.penpot.app/api
|
||||||
PENPOT_USERNAME=your_penpot_username
|
PENPOT_USERNAME=your_penpot_username
|
||||||
@@ -321,6 +333,7 @@ Cursor IDE supports MCP servers through its AI integration features. To configur
|
|||||||
```
|
```
|
||||||
|
|
||||||
4. **Start the MCP server** in your project:
|
4. **Start the MCP server** in your project:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# In your project directory
|
# In your project directory
|
||||||
penpot-mcp
|
penpot-mcp
|
||||||
@@ -335,6 +348,7 @@ Cursor IDE supports MCP servers through its AI integration features. To configur
|
|||||||
### Key Integration Features
|
### Key Integration Features
|
||||||
|
|
||||||
Both Claude Desktop and Cursor integration provide:
|
Both Claude Desktop and Cursor integration provide:
|
||||||
|
|
||||||
- **Direct access** to Penpot projects and files
|
- **Direct access** to Penpot projects and files
|
||||||
- **Visual component analysis** with AI-powered insights
|
- **Visual component analysis** with AI-powered insights
|
||||||
- **Design export capabilities** for assets and components
|
- **Design export capabilities** for assets and components
|
||||||
|
|||||||
Reference in New Issue
Block a user