MCP WordPress Server

# Docker Setup Guide This guide provides step-by-step instructions for setting up the MCP WordPress server using Docker, specifically for Claude Desktop integration. --- ## 🚀 Quick Start ### 1. Pull the Docker Image ```bash docker pull docdyhr/mcp-wordpress:latest ``` ### 2. Add to Claude Desktop configuration ## 🎯 Claude Desktop Integration (Recommended) ### Single-Site Setup Add this to your Claude Desktop configuration file (`~/Library/Application Support/Claude/claude_desktop_config.json`): ```json { "mcpServers": { "mcp-wordpress": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "WORDPRESS_SITE_URL=https://your-site.com", "-e", "WORDPRESS_USERNAME=your_username", "-e", "WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx", "docdyhr/mcp-wordpress:latest" ] } } } ``` ### Multi-Site Setup (Recommended) 1. **Create `mcp-wordpress.config.json`**: ```json { "sites": [ { "id": "site1", "name": "Main Site", "config": { "WORDPRESS_SITE_URL": "https://site1.com", "WORDPRESS_USERNAME": "admin", "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx" } }, { "id": "site2", "name": "Blog Site", "config": { "WORDPRESS_SITE_URL": "https://blog.site2.com", "WORDPRESS_USERNAME": "editor", "WORDPRESS_APP_PASSWORD": "yyyy yyyy yyyy yyyy yyyy yyyy" } } ] } ``` 1. **Add to Claude Desktop configuration**: ```json { "mcpServers": { "mcp-wordpress": { "command": "docker", "args": [ "run", "--rm", "-i", "-v", "/absolute/path/to/mcp-wordpress.config.json:/app/mcp-wordpress.config.json:ro", "docdyhr/mcp-wordpress:latest" ] } } } ``` ## 🔧 Standalone Docker Usage ### Single-Site Mode ```bash # Interactive mode (recommended for testing) docker run --rm -i \ -e WORDPRESS_SITE_URL=https://your-site.com \ -e WORDPRESS_USERNAME=your_username \ -e WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" \ docdyhr/mcp-wordpress:latest # Background mode (for debugging/logs) docker run -d --name mcp-wordpress-debug \ -e WORDPRESS_SITE_URL=https://your-site.com \ -e WORDPRESS_USERNAME=your_username \ -e WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" \ docdyhr/mcp-wordpress:latest ``` ### Multi-Site Mode ```bash # Interactive mode docker run --rm -i \ -v ./mcp-wordpress.config.json:/app/mcp-wordpress.config.json:ro \ docdyhr/mcp-wordpress:latest # Background mode (for debugging/logs) docker run -d --name mcp-wordpress-multisite \ -v ./mcp-wordpress.config.json:/app/mcp-wordpress.config.json:ro \ docdyhr/mcp-wordpress:latest ``` ## 🐳 Docker Compose Setup Create `docker-compose.yml`: ```yaml version: "3.8" services: mcp-wordpress: image: docdyhr/mcp-wordpress:latest container_name: mcp-wordpress restart: unless-stopped volumes: # Mount configuration file (choose one approach) - ./mcp-wordpress.config.json:/app/mcp-wordpress.config.json:ro # OR mount .env file for single-site - ./.env:/app/.env:ro environment: - NODE_ENV=production # Note: No ports exposed - MCP uses stdin/stdout ``` **Start with Docker Compose:** ```bash docker-compose up -d ``` ## 🛠️ Development & Debugging ### View Logs ```bash # For named containers docker logs mcp-wordpress-debug docker logs -f mcp-wordpress-multisite # Follow logs # For Docker Compose docker-compose logs -f mcp-wordpress ``` ### Container Management ```bash # List running containers docker ps # Stop containers docker stop mcp-wordpress-debug docker-compose down # Remove containers docker rm mcp-wordpress-debug ``` ### Test Configuration ```bash # Test single-site setup echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | \ docker run --rm -i \ -e WORDPRESS_SITE_URL=https://your-site.com \ -e WORDPRESS_USERNAME=your_username \ -e WORDPRESS_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx" \ docdyhr/mcp-wordpress:latest # Test multi-site setup echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | \ docker run --rm -i \ -v ./mcp-wordpress.config.json:/app/mcp-wordpress.config.json:ro \ docdyhr/mcp-wordpress:latest ``` ## 🔍 Troubleshooting ### Common Issues **1. MCP Integration Not Working** - ❌ **Problem**: Using `-d` flag in Claude Desktop config - ✅ **Solution**: Remove `-d` flag, use `--rm -i` instead **2. Configuration File Not Found** - ❌ **Problem**: Wrong mount path `/app/config/mcp-wordpress.config.json` - ✅ **Solution**: Use correct path `/app/mcp-wordpress.config.json` **3. Permission Denied** - ❌ **Problem**: Config file not readable by container - ✅ **Solution**: Use absolute paths and check file permissions **4. App Password with Spaces** - ❌ **Problem**: Spaces in password breaking Docker args - ✅ **Solution**: Quote the password in command line, or use config file ### Validation Commands ```bash # Verify image exists docker images | grep mcp-wordpress # Check container health docker run --rm docdyhr/mcp-wordpress:latest --health-check # Validate config file docker run --rm -i \ -v ./mcp-wordpress.config.json:/app/mcp-wordpress.config.json:ro \ docdyhr/mcp-wordpress:latest --validate-config ``` ## 🚨 Important Notes ### ✅ Do's - ✅ Use `--rm -i` for Claude Desktop integration - ✅ Mount config file to `/app/mcp-wordpress.config.json` - ✅ Use absolute paths for volume mounts - ✅ Quote passwords with spaces in command line ### ❌ Don'ts - ❌ **Never use `-d` flag with Claude Desktop** (breaks MCP communication) - ❌ **Don't expose ports** like `-p 3000:3000` (unnecessary for MCP) - ❌ **Don't use named containers** with `--name` for MCP (can cause conflicts) - ❌ **Don't mount to `/app/config/`** (wrong path) ## 🔄 After Setup 1. **Restart Claude Desktop** to load the new configuration 2. **Test the integration** with commands like: - "List my WordPress posts" - "Show my site statistics" - "What WordPress sites do I have configured?" The Docker container will start automatically when Claude Desktop needs to use WordPress tools.