Initial commit: Penpot MCP Server - Complete AI-powered design workflow automation with MCP protocol, Penpot API integration, Claude AI support, CLI tools, and comprehensive documentation

This commit is contained in:
Chema
2025-05-26 19:16:46 +02:00
commit 85e658d2cd
42 changed files with 8159 additions and 0 deletions

45
.github/ISSUE_TEMPLATE/bug_report.md vendored Normal file
View File

@@ -0,0 +1,45 @@
---
name: Bug report
about: Create a report to help us improve Penpot MCP
title: '[BUG] '
labels: 'bug'
assignees: ''
---
**Describe the bug**
A clear and concise description of what the bug is.
**To Reproduce**
Steps to reproduce the behavior:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error
**Expected behavior**
A clear and concise description of what you expected to happen.
**Screenshots**
If applicable, add screenshots to help explain your problem.
**Environment (please complete the following information):**
- OS: [e.g. Ubuntu 22.04, macOS 14.0, Windows 11]
- Python version: [e.g. 3.12.0]
- Penpot MCP version: [e.g. 0.1.0]
- Penpot version: [e.g. 2.0.0]
- AI Assistant: [e.g. Claude Desktop, Custom MCP client]
**Configuration**
- Are you using environment variables or .env file?
- What's your PENPOT_API_URL?
- Any custom configuration?
**Logs**
If applicable, add relevant log output:
```
Paste logs here
```
**Additional context**
Add any other context about the problem here.

View File

@@ -0,0 +1,38 @@
---
name: Feature request
about: Suggest an idea for Penpot MCP
title: '[FEATURE] '
labels: 'enhancement'
assignees: ''
---
**Is your feature request related to a problem? Please describe.**
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
**Describe the solution you'd like**
A clear and concise description of what you want to happen.
**Describe alternatives you've considered**
A clear and concise description of any alternative solutions or features you've considered.
**Use case**
Describe how this feature would be used:
- Who would benefit from this feature?
- In what scenarios would it be useful?
- How would it improve the Penpot MCP workflow?
**Implementation ideas**
If you have ideas about how this could be implemented, please share them:
- API changes needed
- New MCP tools or resources
- Integration points with Penpot or AI assistants
**Additional context**
Add any other context, screenshots, mockups, or examples about the feature request here.
**Priority**
How important is this feature to you?
- [ ] Nice to have
- [ ] Important for my workflow
- [ ] Critical for adoption

51
.github/PULL_REQUEST_TEMPLATE.md vendored Normal file
View File

@@ -0,0 +1,51 @@
## Description
Brief description of the changes in this PR.
## Type of Change
- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] Documentation update
- [ ] Performance improvement
- [ ] Code refactoring
## Related Issues
Fixes #(issue number)
## Changes Made
- [ ] Added/modified MCP tools or resources
- [ ] Updated Penpot API integration
- [ ] Enhanced AI assistant compatibility
- [ ] Improved error handling
- [ ] Added tests
- [ ] Updated documentation
## Testing
- [ ] Tests pass locally
- [ ] Added tests for new functionality
- [ ] Tested with Claude Desktop integration
- [ ] Tested with Penpot API
- [ ] Manual testing completed
## Checklist
- [ ] My code follows the project's style guidelines
- [ ] I have performed a self-review of my code
- [ ] I have commented my code, particularly in hard-to-understand areas
- [ ] I have made corresponding changes to the documentation
- [ ] My changes generate no new warnings
- [ ] I have added tests that prove my fix is effective or that my feature works
- [ ] New and existing unit tests pass locally with my changes
## Screenshots (if applicable)
Add screenshots to help explain your changes.
## Additional Notes
Any additional information that reviewers should know.