WordPress MCP Server 🚀

A Model Context Protocol (MCP) server that enables AI assistants to manage WordPress sites and create content with AI-generated featured images.

✨ Features

• 🌐 Multi-Site Management - Control multiple WordPress sites from a single interface
• 🤖 AI-Powered Content - Create articles with automatic featured image generation using DALL-E 3
• 📝 Smart Publishing - Full control over categories, tags, and post status
• 🔐 Secure Authentication - Uses WordPress Application Passwords for API access
• 🌍 International Support - Full Unicode support for Hebrew, Arabic, and other languages
• ⚡ Bulk Operations - Create multiple articles across different sites efficiently

🎯 Use Cases

• Content Agencies - Manage multiple client WordPress sites from one place
• Blog Networks - Publish content across multiple blogs simultaneously
• AI-Assisted Writing - Let AI help create content with relevant images
• Multilingual Publishing - Create content in any language with proper support

📋 Prerequisites

• Python 3.8 or higher
• Claude Desktop (or any MCP-compatible client)
• WordPress sites with REST API enabled
• OpenAI API key (for image generation)

🚀 Quick Start

1. Clone and Install

git clone https://github.com/seomentor/wpmcp.git
cd wpmcp
pip install -r requirements.txt

2. Configure WordPress Sites

Edit `config/wordpress_sites.yaml`:

sites:
  - id: "site1"
    name: "My WordPress Blog"
    url: "https://myblog.com"
    username: "your-username"
    password: "your-app-password"

3. Set Up OpenAI (Optional, for images)

Create a `.env` file:

OPENAI_API_KEY=your-api-key-here

⚠️ Important Note: If you have an `OPENAI_API_KEY` already set in your Windows/Mac environment variables, it might override the one in `.env`. To avoid conflicts:

• Remove any existing `OPENAI_API_KEY` from your system environment variables, OR
• Add the API key directly to Claude Desktop config (see option 2 below)

4. Configure Claude Desktop

Add to Claude's config file:

Windows: `%APPDATA%\Claude\claude_desktop_config.json`

Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/path/to/wordpress-mcp-server"
    }
  }
}

Option 2: Include OpenAI API Key in Claude Config (Recommended if having issues)

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/path/to/wordpress-mcp-server",
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

5. Start Using!

In Claude Desktop:

"Create an article about AI trends with an image on site1"

📚 Documentation

Available Commands

WordPress Setup

1. Enable REST API (enabled by default in WordPress 5.0+)

2. Create Application Password:

3. Required Permissions:

🎨 Image Generation

The server uses OpenAI's DALL-E 3 for automatic image generation:

• Automatic prompts - Generated from article title and content
• Smart filenames - SEO-friendly names based on content
• Direct upload - Images uploaded directly to WordPress media library
• Featured image - Automatically set as post featured image

Costs

• Standard quality: ~$0.04 per image
• HD quality: ~$0.08 per image

🔧 Advanced Configuration

Environment Variables

OPENAI_API_KEY=sk-...          # OpenAI API key for image generation

Configuration Options

settings:
  default_post_status: "draft"   # draft, publish, private
  default_post_format: "standard"
  max_retries: 3
  timeout: 30

🐛 Troubleshooting

Diagnostic Tool

Run the diagnostic script to check your setup:

python scripts/diagnose.py

This will check:

• Python version
• Required dependencies
• Configuration files
• Environment variables
• OpenAI API key conflicts
• Connection to OpenAI

Common Issues

"Server disconnected"

• Check Python installation
• Verify path in Claude config
• Check for error messages in terminal

"Image generation failed"

• Verify OpenAI API key is valid
• Check API credits
• Ensure proper .env file format
• Check if you have conflicting `OPENAI_API_KEY` in system environment variables
• Try adding the API key directly to Claude Desktop config (see Option 2 above)

"Authentication failed"

• Regenerate WordPress application password
• Check username is correct
• Verify site URL includes protocol (https://)

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository

2. Create your feature branch (`git checkout -b feature/AmazingFeature`)

3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)

4. Push to the branch (`git push origin feature/AmazingFeature`)

5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Model Context Protocol by Anthropic
• WordPress REST API team
• OpenAI for DALL-E 3

📞 Support

• 📧 Email: shay@seomentor.co.il
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

Made with ❤️ by Shay Amos for WordPress developers, SEO`s and AI enthusiasts

Visit my website for more cool apps :) https://www.seomentor.co.il