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

This commit is contained in:
Ismail Ali
2025-07-16 19:47:33 +02:00
parent 37ec03275f
commit 0da75ff11b
3 changed files with 121 additions and 97 deletions

10
.env Normal file
View 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
View File

@@ -30,7 +30,7 @@ env/
.python-version
# Environment variables
.env
#.env
# IDE files
.idea/

View File

@@ -1,5 +1,6 @@
# Penpot MCP Server 🎨🤖
<!-- git test -->
<p align="center">
<img src="images/penpot-mcp.png" alt="Penpot MCP Logo" width="400"/>
</p>
@@ -47,6 +48,7 @@ Check out our demo video to see Penpot MCP in action:
## ✨ Features
### 🔌 Core Capabilities
- **MCP Protocol Implementation**: Full compliance with Model Context Protocol standards
- **Real-time Design Access**: Direct integration with Penpot's API for live design data
- **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
### 🛠️ Developer Tools
- **Command-line Utilities**: Powerful CLI tools for design file analysis and validation
- **Python SDK**: Comprehensive Python library for custom integrations
- **REST API**: HTTP endpoints for web application integration
- **Extensible Architecture**: Plugin system for custom AI workflows
### 🎨 AI Integration Features
- **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
- **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
### For Designers
- **Design Review Automation**: Get instant AI feedback on accessibility, usability, and design principles
- **Component Documentation**: Automatically generate documentation for design systems
- **Design Consistency Checks**: Ensure brand guidelines compliance across projects
- **Asset Organization**: AI-powered tagging and categorization of design components
### For Developers
- **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
- **Automated Testing**: Generate visual regression tests from design specifications
- **Design System Sync**: Keep design tokens and code components in sync
### For Product Teams
- **Design Analytics**: Track design system adoption and component usage
- **Collaboration Enhancement**: AI-powered design reviews and feedback collection
- **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:
>
> 1. Open your web browser and navigate to [https://design.penpot.app](https://design.penpot.app)
> 2. Log in to your Penpot account
> 3. Complete any CloudFlare human verification challenges if prompted
@@ -246,6 +254,7 @@ penpot-client
## MCP Resources & Tools
### Resources
- `server://info` - Server status and information
- `penpot://schema` - Penpot API 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
### Tools
- `list_projects` - List all Penpot projects
- `get_project_files` - Get files for a specific project
- `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:
1. **Install the MCP server** (if not already installed):
```bash
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:
```bash
PENPOT_API_URL=https://design.penpot.app/api
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:
```bash
# In your project directory
penpot-mcp
@@ -335,6 +348,7 @@ Cursor IDE supports MCP servers through its AI integration features. To configur
### Key Integration Features
Both Claude Desktop and Cursor integration provide:
- **Direct access** to Penpot projects and files
- **Visual component analysis** with AI-powered insights
- **Design export capabilities** for assets and components