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:

   • Go to Users → Profile → Application Passwords
   • Generate new password
   • Use in configuration

3. Required Permissions:

   • edit_posts - Create and edit posts
   • upload_files - Upload media
   • manage_categories - Create categories
   • manage_post_tags - Create tags

🎨 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