WP MCP Server

Hosted MCP server that bridges Claude.ai with one or more WordPress sites.

Setup (Ubuntu VPS)

1. Install Node.js

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

2. Deploy the server

# Upload mcp-server/ folder to your VPS, then:
cd mcp-server
npm install

# Copy and edit the .env file
cp .env.example .env
nano .env

Edit .env:

PORT=3000
SERVER_URL=https://mcp.yourdomain.com
SECRET_KEY=your_random_secret_key_here

3. Run with PM2 (keep alive)

npm install -g pm2
pm2 start src/server.js --name wp-mcp-server
pm2 save
pm2 startup

4. Nginx reverse proxy

server {
    listen 80;
    server_name mcp.yourdomain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;

        # Required for SSE
        proxy_buffering off;
        proxy_read_timeout 300s;
        chunked_transfer_encoding on;
    }
}

Then add SSL:

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d mcp.yourdomain.com

5. Test the server

curl https://mcp.yourdomain.com/health

---

Connecting a WordPress Site

After installing the WP MCP Connect plugin on WordPress:

1. Go to Settings → WP MCP Connect
2. Enter your MCP Server URL (https://mcp.yourdomain.com)
3. Enter your Admin Key (the SECRET_KEY from .env)
4. Click Register Site
5. Copy the Connector URL that appears
6. Paste it into Claude.ai → Settings → Connectors

---

Architecture

Claude.ai
    ↓  MCP (SSE)
mcp.yourdomain.com  (this server)
    ↓  REST API + X-MCP-Secret header
yoursite.com/wp-json/wp-mcp-connect/v1/execute
    ↓
WordPress Abilities Registry