# Proto-Blocks MCP Server
The **Ultimate MCP Server** for Proto-Blocks - providing comprehensive AI guidance for creating WordPress Gutenberg blocks with PHP templates.
## Features
- **12 Specialized Tools** for Proto-Blocks development guidance
- **Complete Documentation** covering all aspects of block creation
- **Examples** from basic to expert level complexity
- **Troubleshooting Guides** for common issues
- **Block Generator** to create blocks from descriptions
- **No Build Step Required** - runs directly with npx
## Installation
### Claude Desktop
Add to your Claude Desktop configuration (`claude_desktop_config.json`):
```json
{
"mcpServers": {
"Proto-Blocks MCP": {
"command": "npx",
"args": ["-y", "github:GustavoGomez092/proto-blocks-mcp"]
}
}
}
```
### Local Development
```bash
cd mcp
npm install
node index.js
```
## Available Tools
### Getting Started
- **`proto_blocks_get_started`** - Comprehensive introduction to Proto-Blocks
- **`proto_blocks_quick_reference`** - Quick cheat sheet for common patterns
### Documentation
- **`proto_blocks_field_types`** - Complete field type documentation (text, wysiwyg, image, link, repeater, innerblocks)
- **`proto_blocks_control_types`** - Complete control type documentation (text, select, toggle, range, color, etc.)
- **`proto_blocks_templates`** - PHP template patterns and best practices
- **`proto_blocks_styling`** - Styling with Vanilla CSS or Tailwind
- **`proto_blocks_interactivity`** - Frontend interactivity (plain JS, ES modules, WordPress Interactivity API)
- **`proto_blocks_schema`** - Complete block.json schema reference
### Examples & Troubleshooting
- **`proto_blocks_examples`** - Working examples at all complexity levels (basic, intermediate, advanced, expert)
- **`proto_blocks_troubleshooting`** - Solutions for common issues
### Advanced Features
- **`proto_blocks_repeaters`** - Comprehensive guide to repeaters (basic to complex, nested repeaters, Interactivity API integration)
### Block Generation
- **`proto_blocks_generate`** - Generate complete blocks from a description
## Usage Examples
### Get Started
```
Use the proto_blocks_get_started tool to learn about Proto-Blocks
```
### Get Field Details
```
Use proto_blocks_field_types with fieldType="repeater" to learn about repeater fields
```
### Get Examples
```
Use proto_blocks_examples with complexity="advanced" for advanced examples
```
### Learn About Repeaters
```
Use proto_blocks_repeaters for complete repeater documentation
Use proto_blocks_repeaters with topic="nested" for nested repeater patterns
```
### Generate a Block
```
Use proto_blocks_generate with:
- name: "feature-card"
- title: "Feature Card"
- description: "A card with image, title, description, and link button"
```
## What is Proto-Blocks?
Proto-Blocks is a WordPress plugin that enables developers to create Gutenberg blocks using **PHP/HTML templates** instead of React. Key features:
- **PHP-First Development** - Write blocks in familiar PHP
- **Single Source of Truth** - Everything in `block.json`
- **Optional Tailwind CSS** - Built-in Tailwind support
- **WordPress Interactivity API** - Full support for reactive UIs
- **Template Caching** - Optimized performance
## Resources
- [Proto-Blocks Documentation](https://github.com/GustavoGomez092/proto-blocks)
- [MCP Server Repository](https://github.com/GustavoGomez092/zenblocks-mcp)
## License
MIT
