MCP-WordPress

# CCwithAI WordPress MCP Server A powerful Model Context Protocol (MCP) server for full WordPress content management. Manage posts, pages, media, and SEO metadata (Yoast/RankMath) directly through any MCP-compatible AI client (like Claude Desktop). Designed for the CCwithAI ecosystem, this server allows a single deployment to manage multiple WordPress sites via environment variables. ## 🚀 Features - **Content Management**: Create, read, update, and publish posts and pages. - **Media Handling**: Upload images and set featured images (automatically validates featured images before publishing). - **Gutenberg Compatibility**: Automatically wraps raw HTML in the exact `wp:group` > `wp:html` block structure used by modern WordPress themes. - **Advanced SEO**: Deep integration with Yoast SEO and RankMath (Titles, Descriptions, Focus Keywords, OG tags, and Canonical URLs). - **Schema Support**: Supports custom JSON-LD schema injection via the AI SEO KISS plugin. - **Multi-Site Ready**: Configure site-specific connections via environment variables. --- ## 🛠️ Installation & Setup ### 1. Prerequisites - [Node.js](https://nodejs.org/) (v18+) or [Docker](https://www.docker.com/) - A WordPress site with [Application Passwords](https://wordpress.org/documentation/article/application-passwords/) enabled. ### 2. Generate WordPress Application Password 1. Log in to your WordPress Admin dashboard. 2. Go to **Users** → **Profile**. 3. Scroll down to the **Application Passwords** section. 4. Enter a name for the new password (e.g., `Claude-MCP`). 5. Click **Add New Application Password**. 6. **CRITICAL**: Copy the 24-character password immediately. You will not be able to see it again. ### 3. Choose your Deployment Method #### Option A: Local Node.js (Easiest for development) ```bash git clone https://github.com/CCwithAi/MCP-WordPress.git cd MCP-WordPress npm install npm run build ``` #### Option B: Docker (Recommended for stability) ```bash # Build the image docker build -t wordpress-mcp . # Run the container docker run -d --name wordpress-mcp \ -e WP_SITE_URL="https://your-wordpress-site.com" \ -e WP_USERNAME="your_username" \ -e WP_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" \ wordpress-mcp ``` --- ## 🤖 Configuration for AI Clients ### Claude Desktop Setup Edit your `claude_desktop_config.json`: - **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` #### Using Docker (Recommended) ```json { "mcpServers": { "wordpress-mcp": { "command": "docker", "args": [ "exec", "-i", "-e", "WP_SITE_URL=https://your-site.com", "-e", "WP_USERNAME=your_username", "-e", "WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx", "wordpress-mcp", "node", "dist/index.js" ] } } } ``` #### Using Local Node ```json { "mcpServers": { "wordpress-mcp": { "command": "node", "args": ["/ABSOLUTE/PATH/TO/MCP-WordPress/dist/index.js"], "env": { "WP_SITE_URL": "https://your-site.com", "WP_USERNAME": "your_username", "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx" } } } } ``` --- ## 📝 Usage Notes ### Content Formatting The server automatically handles block markup. When you provide `html_content`, it is wrapped in: ```html <!-- wp:group {"align":"full",...} --> <div class="wp-block-group alignfull"><!-- wp:html --> YOUR_CONTENT_HERE <!-- /wp:html --></div> <!-- /wp:group --> ``` ### Mandatory Featured Images By default, the server enforces a "Featured Image" requirement for blog posts to ensure high-quality presentation. 1. Use `wp_upload_image_from_url` to upload an image. 2. Use the returned `id` as `featured_media_id` in `wp_create_post`. --- ## 📄 License MIT License. Created by [CCwithAI](https://github.com/CCwithAi).