BOIM WordPress Stack MCP MCP Server

BOIM WordPress Stack MCP

A Model Context Protocol (MCP) server that acts as a coding standards and framework guide for LLM connectors (like Claude Desktop or Cursor). It provides WordPress development knowledge, code generation tools, and best practices focused on Gutenberg blocks, GeneratePress theme, GenerateBlocks plugin, and WPCodebox code snippet formatting.

Overview

This MCP server does NOT directly access WordPress websites. Instead, it provides:

• Code Generation Tools: Generate WordPress code following best practices
• Coding Standards: WordPress coding standards validation and formatting
• Framework Guides: Knowledge base for Gutenberg, GeneratePress, GenerateBlocks, and WPCodebox
• Best Practices: Security, performance, and compatibility guidelines

Features

Code Generation

• Gutenberg block code (block.json, PHP registration, React components)
• GenerateBlocks-compatible block code
• WordPress functions, hooks, shortcodes, and REST API endpoints
• WPCodebox-formatted code snippets

Coding Standards

• PHP coding standards validation
• JavaScript coding standards validation
• CSS coding standards validation
• Security best practices (sanitization, escaping, nonces)
• Performance optimization guidelines

Knowledge Base

• WordPress coding standards reference
• Gutenberg block development patterns
• GenerateBlocks development guide
• WPCodebox snippet format specifications
• GeneratePress theme best practices

Quick Start: Connecting the MCP Server

Prerequisites

• Node.js 18.0.0 or higher
• npm or yarn
• Claude Desktop or Cursor installed

Follow these simple steps to connect this MCP server to Claude Desktop or Cursor.

Step 1: Install and Build

1. Clone the repository:

   git clone https://github.com/JTruax/BOIM-WP-MCP.git
   cd BOIM-WP-MCP
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

   Verify the build succeeded: You should see a dist/ directory created with index.js inside it. If the build fails, check that all dependencies installed correctly.

4. Note the full path to the dist/index.js file. You'll need this in the next step.

   To get the full path:

   • macOS/Linux: Run pwd in the terminal after cd BOIM-WP-MCP, then append /dist/index.js
   • Windows: Run cd in Command Prompt after cd BOIM-WP-MCP, then append \dist\index.js

   Example paths:

   • macOS/Linux: /Users/yourname/BOIM-WP-MCP/dist/index.js
   • Windows: C:\\Users\\yourname\\BOIM-WP-MCP\\dist\\index.js (use double backslashes \\ in JSON, or forward slashes /)

Step 2: Configure Claude Desktop

1. Locate your Claude Desktop config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Open the config file in a text editor. If it doesn't exist, create it.

3. Add the MCP server configuration:

   If the file is empty or doesn't have mcpServers, use this:

   {
     "mcpServers": {
       "wordpress-gutenberg": {
         "command": "node",
         "args": ["/full/path/to/BOIM-WP-MCP/dist/index.js"]
       }
     }
   }
   

   If the file already has mcpServers, add to the existing object:

   {
     "mcpServers": {
       "existing-server": { ... },
       "wordpress-gutenberg": {
         "command": "node",
         "args": ["/full/path/to/BOIM-WP-MCP/dist/index.js"]
       }
     }
   }
   

4. Replace /full/path/to/BOIM-WP-MCP/dist/index.js with your actual path from Step 1.

5. Save the file and restart Claude Desktop.

Step 3: Configure Cursor

1. Open Cursor Settings:

   • Press Cmd/Ctrl + Shift + P to open the command palette
   • Type "Preferences: Open User Settings (JSON)" and select it
   • Or go to Settings → Extensions → MCP (if available)

2. Add the MCP server configuration:

   Add this to your Cursor settings JSON:

   {
     "mcp.servers": {
       "wordpress-gutenberg": {
         "command": "node",
         "args": ["/full/path/to/BOIM-WP-MCP/dist/index.js"]
       }
     }
   }
   

3. Replace /full/path/to/BOIM-WP-MCP/dist/index.js with your actual path from Step 1.

4. Save the settings and restart Cursor.

Step 4: Verify Connection

1. Restart your application (Claude Desktop or Cursor).

2. Check for the MCP server:

   • In Claude Desktop: The server should appear in the MCP servers list
   • In Cursor: Check the MCP status indicator

3. Test a tool:

   • Try asking: "Generate a Gutenberg block called 'custom-card'"
   • Or: "Format this PHP code for WPCodebox: [your code]"

Troubleshooting

MCP server not appearing?

• Verify the path to dist/index.js is correct and absolute (not relative)
• Make sure you ra