WordPress MCP Bridge (wp_mcp)

An AI-controlled WordPress management, design, and SEO engine that connects Claude Code, Gemini, and Codex to a live WordPress website via the Model Context Protocol (MCP).

🚀 Key Features

• AI Agent Coordination: Taps into the specific strengths of Claude (orchestration & Yoast/Elementor SEO), Gemini (Hub & Spoke content scaling & alt-text generation), and Codex (critical CSS & PageSpeed optimizations).
• Elementor Page Editor: Directly reads, formats, and updates the layout structure of pages built with Elementor's custom JSON schema.
• Yoast SEO Integration: Inspects pages and updates SEO titles, meta descriptions, and schema tags programmatically.
• Safe Write Actions: Implements snapshot-before-write logic enabling one-click rollbacks for any post or metadata modification.
• Server Shell Bridge: Securely executes remote WP-CLI commands and SFTP file uploads directly from your terminal.

📦 Quick Start Guide

1. Clone the Repository

git clone https://github.com/biolashonde/wp_mcp.git
cd wp_mcp

2. Install Dependencies

npm install

3. Setup Your Environment

Copy the example environment file and configure your WordPress API credentials, SSH details, and AI keys:

cp .env.example .env

4. Start the MCP Server

npm start

The MCP server will launch locally on http://localhost:3000.

🛠️ CLI Workflow Commands

Run these scripts from your local terminal to invoke advanced AI actions:

• Setup WordPress Installation:

  npm run setup
  

• Optimize SEO on a Post:

  npm run seo -- --post-id <POST_ID>
  

• Generate Hub & Spoke Content (Gemini):

  npm run content -- --topic "Automation & Good Code" --spokes 3
  

• Boost PageSpeed Score:

  npm run perf -- --url <PAGE_URL>
  

• Revert a Change:

  npm run revert -- --id <REVERT_ID>
  

📖 In-Depth Documentation

For full details on the system architecture, remote host setup, REST API credentials, and troubleshooting guides, please see the DOCUMENTATION.md file.