MCP 服务器

Proto-Blocks MCP Server

Provides comprehensive AI guidance and tools for creating WordPress Gutenberg blocks using PHP templates instead of React. Includes 12 specialized tools covering documentation, examples, troubleshooting, and a block generator for Proto-Blocks development.

README

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):

{
  "mcpServers": {
    "Proto-Blocks MCP": {
      "command": "npx",
      "args": ["-y", "github:GustavoGomez092/proto-blocks-mcp"]
    }
  }
}

Local Development

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"