wp_mcp

# 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 ```bash git clone https://github.com/biolashonde/wp_mcp.git cd wp_mcp ``` ### 2. Install Dependencies ```bash npm install ``` ### 3. Setup Your Environment Copy the example environment file and configure your WordPress API credentials, SSH details, and AI keys: ```bash cp .env.example .env ``` ### 4. Start the MCP Server ```bash 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**: ```bash npm run setup ``` * **Optimize SEO on a Post**: ```bash npm run seo -- --post-id <POST_ID> ``` * **Generate Hub & Spoke Content (Gemini)**: ```bash npm run content -- --topic "Automation & Good Code" --spokes 3 ``` * **Boost PageSpeed Score**: ```bash npm run perf -- --url <PAGE_URL> ``` * **Revert a Change**: ```bash 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`**](DOCUMENTATION.md) file.