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
|
||||
|
||||
# Environment variables
|
||||
.env
|
||||
#.env
|
||||
|
||||
# IDE files
|
||||
.idea/
|
||||
|
||||
14
README.md
14
README.md
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user