WordPress MCP管理工具

Prerequisites

• WordPress: Version 5.6+ with REST API enabled
• Claude Desktop: Latest version installed
• Application Password: Generated from WordPress admin panel

🔧 Requirements

• WordPress 5.0+ with REST API enabled
• HTTPS recommended for production
• User with appropriate permissions
• Application Passwords enabled (WordPress 5.6+)

3-Step Setup

1️⃣ Generate WordPress Application Password

WordPress Admin → Users → Profile → Application Passwords → Add New

2️⃣ Install MCP Server (Choose One)

Option A: DXT Extension (Easiest)

```bash

Download and install in Claude Desktop

curl -L https://github.com/docdyhr/mcp-wordpress/releases/latest/download/mcp-wordpress.dxt -o mcp-wordpress.dxt

Then: Claude Desktop → Extensions → Install → Select DXT file

**Option B: NPM Global Install**

**3️⃣ Test Your Connection**

📺 Watch 2-minute Setup Video | 📖 Detailed Setup Guide

⚡ Installation Options

Interactive setup wizard

npm run setup ```

Single Site Setup

Environment Variables (.env)

WORDPRESS_SITE_URL=https://myblog.com
WORDPRESS_USERNAME=admin
WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx
WORDPRESS_AUTH_METHOD=app-password

Claude Desktop Config

{
  "mcpServers": {
    "mcp-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-wordpress"],
      "env": {
        "WORDPRESS_SITE_URL": "https://myblog.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Multi-Site Agency Setup

Configuration File (mcp-wordpress.config.json)

{
  "sites": [
    {
      "id": "main-corporate",
      "name": "Corporate Website",
      "config": {
        "WORDPRESS_SITE_URL": "https://company.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx",
        "WORDPRESS_AUTH_METHOD": "app-password"
      }
    },
    {
      "id": "client-restaurant",
      "name": "Restaurant Client",
      "config": {
        "WORDPRESS_SITE_URL": "https://bestrestaurant.com",
        "WORDPRESS_USERNAME": "editor",
        "WORDPRESS_APP_PASSWORD": "yyyy yyyy yyyy yyyy yyyy yyyy",
        "WORDPRESS_AUTH_METHOD": "app-password"
      }
    },
    {
      "id": "client-ecommerce",
      "name": "E-commerce Client",
      "config": {
        "WORDPRESS_SITE_URL": "https://onlinestore.com",
        "WORDPRESS_USERNAME": "shopmanager",
        "WORDPRESS_APP_PASSWORD": "zzzz zzzz zzzz zzzz zzzz zzzz",
        "WORDPRESS_AUTH_METHOD": "app-password"
      }
    }
  ]
}

docker-compose.yml

version: "3.8" services: wordpress: image: wordpress:latest ports: - "8080:80" environment: WORDPRESS_DB_HOST: db WORDPRESS_DB_USER: wordpress WORDPRESS_DB_PASSWORD: wordpress WORDPRESS_DB_NAME: wordpress volumes: - wordpress_data:/var/www/html

db: image: mysql:8.0 environment: MYSQL_DATABASE: wordpress MYSQL_USER: wordpress MYSQL_PASSWORD: wordpress MYSQL_ROOT_PASSWORD: rootpassword volumes: - db_data:/var/lib/mysql

volumes: wordpress_data: db_data:

**MCP WordPress Development Config**

Production Deployment

Server Environment Variables

```bash

Dockerfile.production

FROM node:20-alpine WORKDIR /app COPY package*.json ./ RUN npm ci --only=production COPY dist/ ./dist/ EXPOSE 3000 USER node CMD ["node", "dist/index.js"] ```

JWT Authentication Setup

WordPress Plugin Configuration

// wp-config.php
define('JWT_AUTH_SECRET_KEY', 'your-secret-key-here');
define('JWT_AUTH_CORS_ENABLE', true);

MCP Configuration

{
  "sites": [
    {
      "id": "jwt-site",
      "name": "JWT Authentication Site",
      "config": {
        "WORDPRESS_SITE_URL": "https://site-with-jwt.com",
        "WORDPRESS_USERNAME": "api-user",
        "WORDPRESS_PASSWORD": "user-password",
        "WORDPRESS_AUTH_METHOD": "jwt"
      }
    }
  ]
}

🔐 Authentication Setup

Test specific site in multi-site setup

npm run status -- --site="your-site-id"

**Authentication Problems**

Install globally instead

npm install -g mcp-wordpress ```

Test Your Installation

```bash

Re-run setup wizard

npm run setup ```

Getting Started

• Quick Start Guide - Get running in 5 minutes
• Installation Guide - Detailed setup instructions
• Configuration Guide - All configuration options
• Authentication Setup - WordPress auth methods

Deployment & Operations

• Docker Deployment - Container deployment
• Publishing Troubleshooting - Fix publishing issues
• Security Best Practices - Production security
• Performance Tuning - Optimization guide
• Monitoring - Logging and metrics

📦 Installation Options

Global installation

npm install -g mcp-wordpress

Docker Images

```bash

🚀 Quick Start

Get up and running in under 5 minutes:

📋 Configuration Examples

🎯 Real-World Use Cases

Content Creation & Management:

💬 "Analyze my top 10 blog posts and create a new post about emerging trends"
💬 "Upload these 5 images and create a photo gallery page with SEO optimization"
💬 "Review all pending comments and approve the legitimate ones"

Site Management & Analytics:

💬 "Check my WordPress site performance and provide optimization recommendations"
💬 "Create a new user account for my freelance writer with editor permissions"
💬 "Backup my site settings and show me cache performance statistics"

Bulk Operations:

💬 "Update all posts from 2023 to include my new author bio"
💬 "Find all images over 1MB and suggest compression strategies"
💬 "List all users who haven't logged in for 6 months"

📚 Examples

🚀 Advanced Automation Examples

User Guides

• Basic Usage - Common tasks and workflows
• Advanced Workflows - Complex automation
• Multi-Site Management - Managing multiple sites
• Troubleshooting - Common issues and solutions

Integration Guides

• Claude Desktop - Complete Claude integration
• VS Code - VS Code extension setup
• Cline - Cline AI assistant integration
• Custom Clients - Build your own MCP client

Direct usage (recommended)

npx -y mcp-wordpress ```

🔧 Other Options

• 💻 NPM Setup - Local development
• 🐳 Docker Setup - Production deployment
• 🔧 Manual Build - Custom builds

Development Environment

Local WordPress with Docker

```yaml

/etc/environment or systemd service

WORDPRESS_SITE_URL=https://production-site.com WORDPRESS_USERNAME=api-user WORDPRESS_APP_PASSWORD=secure-production-password WORDPRESS_AUTH_METHOD=app-password NODE_ENV=production CACHE_ENABLED=true CACHE_TTL=3600 RATE_LIMIT_ENABLED=true DEBUG=false

**Docker Production Setup**

🌐 Multi-Site Configuration

Perfect for agencies and developers managing multiple WordPress sites:

{
  "sites": [
    {
      "id": "main-site",
      "name": "Main WordPress Site",
      "config": {
        "WORDPRESS_SITE_URL": "https://site1.com",
        "WORDPRESS_USERNAME": "admin",
        "WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    },
    {
      "id": "client-blog",
      "name": "Client Blog",
      "config": {
        "WORDPRESS_SITE_URL": "https://client-blog.com",
        "WORDPRESS_USERNAME": "editor",
        "WORDPRESS_APP_PASSWORD": "yyyy yyyy yyyy yyyy yyyy yyyy"
      }
    }
  ]
}

Use with site parameter: wp_list_posts --site="main-site"

📖 Complete Multi-Site Setup Guide

⚙️ Configuration Methods

Option 1: DXT Extension (Recommended)

No configuration needed - built-in secure credential management!

Option 2: NPX in Claude Desktop

{
  "mcpServers": {
    "mcp-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-wordpress"],
      "env": {
        "WORDPRESS_SITE_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

📖 Complete Integration Guide

Environment-Specific Solutions

Claude Desktop Integration

// Verify claude_desktop_config.json format
{
  "mcpServers": {
    "mcp-wordpress": {
      "command": "npx",
      "args": ["-y", "mcp-wordpress"],
      "env": {
        "WORDPRESS_SITE_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

Docker Deployment Issues

```bash

Verify environment variables

docker exec mcp-wordpress env | grep WORDPRESS

Test REST API directly

curl https://your-site.com/wp-json/wp/v2/

Check if REST API is disabled

grep -r "rest_api" wp-config.php

🏆 Recommended: Claude Desktop Extension (DXT)

Easiest installation - just 2 clicks!

1. Download: mcp-wordpress.dxt (3.4MB) 2. Install: Claude Desktop → Extensions → Install → Select DXT file 3. Configure: Enter your WordPress site URL and credentials

✅ Zero command line required ✅ Easy updates ✅ Built-in security

📖 Complete DXT Setup Guide →

🤖 Claude Desktop Integration

Advanced Workflows

SEO-Optimized Content Creation

You: "Create an SEO-optimized blog post about 'WordPress Security Best Practices' with:
     - Focus keyword: 'WordPress security'
     - Meta description
     - Proper heading structure
     - At least 1500 words"

Claude: "I'll create a comprehensive SEO-optimized post on WordPress security..."

Bulk Operations

You: "Find all draft posts older than 30 days and provide a summary"
You: "Update all posts in category 'News' to include a disclaimer at the end"
You: "Delete all spam comments from the last week"

🎨 Real-World Workflows

Content Marketing Agency Workflow

Scenario: Managing 20+ client blogs with consistent SEO optimization

💬 "Analyze the top 5 performing posts across all sites and create similar content for underperforming clients"
💬 "Batch update all client sites with the new privacy policy footer"
💬 "Generate a weekly performance report comparing all client sites"
💬 "Create social media snippets from the latest blog posts on each site"

Smart Content Workflows

Automated SEO Optimization

You: "Optimize all posts from the last month for better SEO performance"
Claude: "I'll analyze and optimize your recent posts...
- Analyzed 15 posts from the last 30 days
- Updated meta descriptions for 12 posts
- Added focus keywords to 8 posts
- Optimized heading structure in 10 posts
- Improved internal linking in 15 posts
- Average SEO score improved from 67% to 89%"

Two additional tools are available: wp_seo_track_serp_positions and wp_seo_keyword_research. By default they estimate keyword coverage from your WordPress content. You can upgrade to real Google Search Console data:

Google Search Console Integration (optional)

1. Create OAuth2 credentials (Desktop app) in Google Cloud Console and enable the Search Console API. 2. Run the setup helper to obtain a refresh token:

   GOOGLE_CLIENT_ID=xxx GOOGLE_CLIENT_SECRET=yyy node scripts/google-auth.mjs
   

   SEO_PROVIDER_SEARCH_CONSOLE=true
   GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
   GOOGLE_CLIENT_SECRET=GOCSPX-your-secret
   GOOGLE_REFRESH_TOKEN=1//your-refresh-token
   

When enabled, wp_seo_track_serp_positions returns real average positions, clicks, impressions, and CTR from your Search Console property. wp_seo_keyword_research returns top queries containing the seed keyword, sorted by impressions. If credentials are missing or the API is unreachable, both tools fall back silently to WordPress content analysis.

Content Gap Analysis

You: "Identify content gaps in our blog compared to competitor topics"
Claude: "After analyzing your content and common industry topics...
- Missing topics: 'AI in Healthcare', 'Remote Work Security', 'Green Technology'
- Underperforming categories: 'Tutorials' (only 3 posts vs 15+ needed)
- Recommended: 8 new posts to fill major gaps
- Priority topics based on search volume and competition"

NPM Package

```bash

🚀 Alternative: NPX (Power Users)

```bash

🏆 Feature Comparison

Alternative Methods

• JWT Authentication - With JWT plugin
• Basic Authentication - Username/password (dev only)
• API Key Authentication - With API Key plugin

📖 Complete Authentication Guide

🛠️ Troubleshooting Guide

🐛 Troubleshooting