WordPress 开发 MCP 服务

Claude Desktop / Claude Code
│
├── 🌐 wordpress-com            REMOTE  HTTP + OAuth 2.1  →  public-api.wordpress.com
│   Automattic · auto-installed with plugin                   17 tools — content authoring,
│                                                              site settings, stats, users,
│                                                              security, subscriptions
│
├── 🎨 wordpress.com            PLUGIN  skills only        →  Claude Code plugin system
│   Automattic · v0.0.1                                        4 commands — /design-site
│   Marketplace: claude-plugins-official                       /preview-designs  /quick-build
│                                                              /site-specification
│
├── 🖥  wordpress-studio         LOCAL   stdio              →  npx wp-studio@latest mcp
│   Automattic · wp-studio@1.7.7                               13 tools — site lifecycle,
│                                                              WP-CLI, preview, screenshot
│
└── 🔧 wordpress-studio-mcp     LOCAL   stdio              →  node dist/index.js
    This project · github.com/movinginfo/wordpress-studio-mcp  61 tools — filesystem,
                                                               SQLite DB, WP-CLI, REST API,
                                                               security audit, wp-config mgmt,
                                                               theme tokens, blueprints,
                                                               WP.com MCP proxy,
                                                               VIP Design System,
                                                               Xdebug, Abilities API,
                                                               marketing skills

git clone https://github.com/movinginfo/wordpress-studio-mcp.git "C:\Work\wordpress-studio-mcp"
cd "C:\Work\wordpress-studio-mcp"
npm install
npm run build

node "C:\Work\wordpress-studio-mcp\dist\index.js"
# Shows startup banner on stderr, then waits — press Ctrl+C to exit

notepad "$env:APPDATA\Claude\claude_desktop_config.json"

{
  "preferences": {
    "coworkScheduledTasksEnabled": false,
    "ccdScheduledTasksEnabled": true,
    "sidebarMode": "code",
    "coworkWebSearchEnabled": true
  },
  "mcpServers": {
    "wordpress-studio-mcp": {
      "command": "node",
      "args": [
        "C:\\Work\\wordpress-studio-mcp\\dist\\index.js"
      ],
      "env": {
        "STUDIO_HOME": "C:\\Users\\YourName\\.studio",
        "STUDIO_SITES_ROOT": "C:\\Users\\YourName\\Studio\\sites"
      }
    },
    "wordpress-studio": {
      "command": "npx",
      "args": ["-y", "wp-studio@latest", "mcp"]
    }
  }
}

✓ wordpress-studio-mcp    57 tools
✓ wordpress-studio        13 tools
✓ wordpress-com           17 tools   (after plugin install)

git clone https://github.com/movinginfo/wordpress-studio-mcp.git "C:\Work\wordpress-studio-mcp"
cd "C:\Work\wordpress-studio-mcp"
npm install
npm run build

# This extension — 27 tools
claude mcp add --scope user wordpress-studio-mcp `
    --env "STUDIO_HOME=C:\Users\$env:USERNAME\.studio" `
    --env "STUDIO_SITES_ROOT=C:\Users\$env:USERNAME\Studio\sites" `
    -- node "C:\Work\wordpress-studio-mcp\dist\index.js"

# Official Studio MCP — 13 tools
claude mcp add --scope user wordpress-studio `
    -- npx -y wp-studio@latest mcp

claude plugins install wordpress.com

claude mcp list

notepad "$env:USERPROFILE\.claude\settings.json"

{
  "mcpServers": {
    "wordpress-studio-mcp": {
      "command": "node",
      "args": ["C:\\Work\\wordpress-studio-mcp\\dist\\index.js"],
      "env": {
        "STUDIO_HOME": "C:\\Users\\YourName\\.studio",
        "STUDIO_SITES_ROOT": "C:\\Users\\YourName\\Studio\\sites"
      },
      "type": "stdio"
    },
    "wordpress-studio": {
      "command": "npx",
      "args": ["-y", "wp-studio@latest", "mcp"],
      "type": "stdio"
    }
  }
}

git clone https://github.com/movinginfo/wordpress-studio-mcp.git "C:\Work\wordpress-studio-mcp"
cd "C:\Work\wordpress-studio-mcp"
npm install
npm run build

{
  "servers": {
    "wordpress-studio": {
      "type": "stdio",
      "command": "node",
      "args": ["C:\\Work\\wordpress-studio-mcp\\dist\\index.js"]
    }
  }
}

"mcp": {
  "servers": {
    "wordpress-studio": {
      "type": "stdio",
      "command": "node",
      "args": ["C:\\Work\\wordpress-studio-mcp\\dist\\index.js"]
    }
  }
}

cd "C:\Work\Wordpress Studio MCP Plugin for Claude Code"
npm link

$npmBin = "$env:APPDATA\npm"
$current = [Environment]::GetEnvironmentVariable("PATH", "User")
if ($current -notlike "*$npmBin*") {
    [Environment]::SetEnvironmentVariable("PATH", "$current;$npmBin", "User")
    Write-Host "Done — restart terminal to apply"
}

wpstudio list                              # all 71 tools grouped by category
wpstudio help <tool>                       # parameters for a tool
wpstudio --version                         # print version

# List all Studio sites
wpstudio studio-registry

# List plugins on a site
wpstudio wpcli-plugin-list --site i-help.us

# Query the database
wpstudio db-query --site i-help.us --sql "SELECT option_name, option_value FROM wp_options LIMIT 5"

# Run any WP-CLI command
wpstudio wpcli-run --site i-help.us --cmd "cache flush"

# Toggle Xdebug
wpstudio studio-xdebug-enable --site i-help.us --confirmed true

# Install all marketing skills
wpstudio marketing-skills-install --skills all --scope global

# Raw JSON output (pipeable to jq)
wpstudio studio-registry --json
wpstudio studio-registry --json | jq '.content[0].text'

wp_theme_json (section: colors)  → get palette slugs
wp_theme_json (section: fonts)   → get font size slugs
wp_theme_json (section: blocks)  → get per-block overrides
→ use slugs in block attributes, not hard-coded hex/px

{
  "method": "tools/call",
  "params": {
    "name": "wpcom-mcp-site-statistics",
    "arguments": { "wpcom_site": "mysite.wordpress.com", "views": true }
  }
}

http://testmysite.com
  → hosts file: 127.0.0.1 testmysite.com   ← added by studio_site_set_domain
  → Studio proxy on port 80 receives request
  → proxy looks up domain → port 8883
  → forwards to http://localhost:8883
  → WordPress: WP_HOME = WP_SITEURL = http://testmysite.com ✓

studio_site_set_domain  site:wordptest.com  domain:testmysite.com  confirmed:true

Add-Content -Path "C:\Windows\System32\drivers\etc\hosts" -Value "`n# BEGIN WordPress Studio`n127.0.0.1 testmysite.com # Studio port 8883`n# END WordPress Studio"

1. studio site create  name:testmysite          → localhost:8883
2. Import DB from live site via wpcli_db_backup + wp db import
3. Copy wp-content/ files with fs_write_file or rsync
4. studio_site_set_domain site:testmysite domain:testmysite.com confirmed:true
5. Run PowerShell hosts command as Administrator (if auto-write failed)
6. Restart site in Studio → open http://testmysite.com  ← identical to live

Before: Site URL → i-help.us        (http)
After:  Site URL → i-helpus.wp.local (https)   ← Studio renamed it automatically

# Download mkcert.exe directly (no package manager needed)
Invoke-WebRequest -Uri "https://github.com/FiloSottile/mkcert/releases/download/v1.4.4/mkcert-v1.4.4-windows-amd64.exe" -OutFile "C:\Windows\System32\mkcert.exe"
mkcert --version

https-certificates\setup-https.bat   ← double-click, enter domain, click Yes on UAC

brew install mkcert nss

studio_site_use_mkcert  site:i-help.us  domain:i-help.us  confirmed:true

1. studio_xdebug_enable  site:mysite  confirmed:true
   → patches cli.json, shows restart reminder

2. Restart site in Studio (stop → start)

3. studio_xdebug_ide_config  site:mysite  ide:vscode  write_file:true
   → writes .vscode/launch.json with correct pathMappings

4. Open site folder in VS Code → F5 → set breakpoints → load site in browser

{
  "configurations": [{
    "name": "Listen for Xdebug (WordPress Studio)",
    "type": "php",
    "request": "launch",
    "port": 9003,
    "pathMappings": {
      "/wordpress": "/Users/you/Studio/mysite"
    }
  }]
}

WordPress plugin registers ability with mcp.public=true
  → MCP Adapter exposes it at /wp-json/mcp/mcp-adapter-default-server
  → wp_abilities_discover lists it
  → wp_abilities_call executes it with params
  → result returned to Claude

1. wp_mcp_adapter_setup  site:mysite  confirmed:true
   → installs abilities-api + mcp-adapter from GitHub
   → runs composer install (if composer available)
   → creates Application Password for HTTP auth

2. wp_abilities_discover  site:mysite
   → lists all public abilities registered on the site

3. wp_abilities_info  site:mysite  ability:my-plugin/my-ability
   → returns parameters schema, description, type

4. wp_abilities_call  site:mysite  ability:my-plugin/my-ability  params:{"key":"value"}
   → executes the ability, returns result

wp_register_ability([
    'name'        => 'my-plugin/send-email',
    'label'       => 'Send Email',
    'description' => 'Send an email to a WordPress user',
    'mcp.public'  => true,
    'callback'    => function(array $params): array {
        wp_mail($params['to'], $params['subject'], $params['message']);
        return ['sent' => true];
    },
]);

http://localhost:PORT/wp-json/mcp/mcp-adapter-default-server

1. marketing_skills_install  skills:product-marketing-context  scope:global
   → installs the foundation context skill first

2. marketing_skills_install  skills:all  scope:global
   → installs all 34 skills to ~/.claude/skills/

3. In Claude Code: /product-marketing-context
   → Claude asks about your product, audience, and positioning

4. In Claude Code: /landing-page-optimizer
   → Claude uses your product context to optimize landing pages

5. marketing_skills_status
   → verify all skills are installed

wp_security_audit site:mysite           → identify gaps
wp_config_set constant:DISALLOW_FILE_EDIT value:true
wp_config_set constant:DISALLOW_FILE_MODS value:true
wp_config_set constant:WP_AUTO_UPDATE_CORE value:"minor"
wpcli_db_backup site:mysite             → snapshot before changes
wpcli_update_all site:mysite what:both  → apply updates
wp_security_audit site:mysite           → verify resolved

wp_config_set constant:WP_DEBUG value:true
wp_config_set constant:WP_DEBUG_LOG value:true
wp_config_set constant:WP_DEBUG_DISPLAY value:false
fs_read_error_log site:mysite lines:50  → tail the log
wp_config_set constant:WP_DEBUG value:false  → disable when done

1. vip_design_tokens section:semantic        → get brand colors
2. vip_design_theme_json style:default       → generate theme.json
3. fs_write_file path:themes/{theme}/theme.json  → write to site
4. wpcli_theme_activate slug:{theme}         → activate theme

{
  "$schema": "https://playground.wordpress.net/blueprint-schema.json",
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "steps": [
    { "step": "setSiteOptions", "options": { "blogname": "My Dev Site", "permalink_structure": "/%postname%/" } },
    { "step": "defineWpConfigConsts", "consts": { "WP_DEBUG": true, "WP_DEBUG_LOG": true } },
    { "step": "installPlugin", "pluginData": { "resource": "wordpress.org/plugins", "slug": "query-monitor" }, "options": { "activate": true } },
    { "step": "installTheme",  "themeData":  { "resource": "wordpress.org/themes",  "slug": "twentytwentyfour" }, "options": { "activate": true } }
  ]
}

wp core version                          # WordPress version
wp core verify-checksums                 # Verify core file integrity
wp option get siteurl                    # Get site URL
wp option get blogname                   # Get site name
wp option list --search="active_plugins" # See active plugins

wp plugin list                           # All plugins with status
wp plugin install woocommerce --activate # Install + activate
wp plugin activate contact-form-7        # Activate installed plugin
wp plugin deactivate akismet             # Deactivate
wp plugin delete hello-dolly            # Delete plugin files
wp plugin update --all                   # Update all plugins

wp theme list                            # All themes with status
wp theme install astra --activate        # Install + activate
wp theme activate twentytwentyfour       # Switch active theme
wp theme delete twentytwentyOne          # Delete theme files

wp user list                             # All users
wp user create john john@example.com --role=editor --user_pass=password
wp user update 1 --user_pass=newpassword # Change admin password
wp user delete 3 --reassign=1           # Delete user, reassign content
wp user add-role 2 administrator         # Add role to user

wp post list --post_type=post --post_status=publish   # Published posts
wp post list --post_type=page                         # All pages
wp post create --post_title="Hello" --post_status=publish --post_type=post
wp post delete 42 --force                             # Permanently delete
wp post meta get 42 _thumbnail_id                     # Get post meta

wp db query "SELECT ID, post_title FROM wp_posts WHERE post_status='publish'"
wp db export backup.sql                  # Export full DB to SQL
wp db import backup.sql                  # Import from SQL
wp db size                               # DB size breakdown
wp db tables                             # List all tables
wp search-replace "http://old.local" "https://new.com" --dry-run
wp search-replace "http://old.local" "https://new.com" --precise

wp cache flush                           # Flush object cache
wp transient delete --all                # Delete all transients
wp rewrite flush                         # Flush rewrite rules
wp cron event list                       # List scheduled events
wp cron event run wp_scheduled_delete    # Run a cron event manually

wp eval "echo phpversion();"             # Run PHP inline
wp eval-file debug-script.php           # Run a PHP file
wp maintenance-mode activate             # Enable maintenance mode
wp maintenance-mode deactivate           # Disable maintenance mode
wp error_log                             # Read error log
wp doctor check --all                    # Site health diagnostics

wp wc product list                       # List products
wp wc order list --status=processing    # Processing orders
wp wc tool run clear_transients          # Clear WC transients

# 1. Dry run — preview changes
"Dry-run search-replace http://mysite.local → https://mysite.com on site mysite"

# 2. Review output, then apply
"Apply the search-replace http://mysite.local → https://mysite.com on site mysite"

# 3. Flush caches after migration
"Flush all caches on site mysite"

action: "list"     → discover all available operations
action: "describe" → get the full input schema for an operation
action: "execute"  → run the operation (requires user_confirmed: true)

{
  "siteBrief": {
    "siteName":      "Bean & Brew",
    "siteType":      "restaurant",
    "primaryGoal":   "Drive in-store visits and online orders",
    "audience":      "Local coffee enthusiasts, remote workers",
    "tone":          "warm, artisanal, community-focused",
    "brandKeywords": ["cozy", "handcrafted", "local", "sustainable"]
  },
  "layoutNotes": [
    "Hero with full-bleed café atmosphere photo",
    "Menu section with three categories",
    "Location and hours with embedded map"
  ],
  "typography": {
    "primaryFont":  "Playfair Display",
    "secondaryFont": "Lato",
    "fontImport":   "https://fonts.googleapis.com/css2?family=..."
  }
}

User:  /quick-build "SaaS landing page, dark mode, modern"

→  /site-specification extracts spec
→  /preview-designs generates 3 options
→  user picks one
→  full block theme built (theme.json, style.css, functions.php, templates)
→  theme activated on local Studio site

# Full site build
/quick-build "coffee shop website, warm rustic feel, three menu sections"

# Design exploration
/preview-designs "portfolio site for a UI designer, clean minimal"

# Site inspection
Show me all my local WordPress Studio sites and their disk usage

# Theme editing
Read the functions.php from the active theme on site "my-shop"
Find all PHP files in the active theme on site "my-shop"

# Database
Show me all published posts from the "my-shop" SQLite database
Export the full "my-shop" database as a SQL dump

# Plugins
Install WooCommerce on site "my-shop" and activate it
List all active plugins on site "my-shop" with their versions

# Debugging
Show the last 100 lines of the PHP error log for site "my-shop"
Run wp doctor check on site "my-shop"

# URL migration
Dry-run search-replace http://my-shop.local → https://myshop.com on site "my-shop"

# WordPress.com (hosted sites)
Show me traffic stats for mysite.wordpress.com for the last 30 days
Search for all draft posts on mysite.wordpress.com
List all active plugins on mysite.wordpress.com

# Local REST API
List all available REST API routes on site "my-shop"
Get all published posts from site "my-shop" via the REST API
Show site settings for "my-shop" using Application Password user:password
Create a draft post on "my-shop" via wp_rest_request (requires confirmation)

# Theme design tokens
Show me the color palette and font sizes from the active theme on site "my-shop"
Get all theme.json design tokens from site "my-shop" before I write block content
What colors are available in the active WordPress.com theme on mysite.wordpress.com?

# VIP Design System
Show me the VIP DS color palette for the gold brand colors
Get the full semantic color roles from the VIP Design System
Generate a WordPress theme.json using VIP Design System tokens (style: default)
Generate a dark-mode theme.json using the VIP Design System
What components are available in the VIP Design System?

# Blueprints
Show me the built-in Commerce blueprint
Generate a blueprint from my site "my-shop" so I can recreate it
Apply the Development blueprint to site "my-shop" (installs debug tools)
Apply this blueprint JSON to site "new-site": { ... }

# WordPress.com MCP proxy
Call wpcom-mcp-site-statistics for mysite.wordpress.com via wpcom_mcp_call
List all available official WordPress.com MCP tools

ls "$env:USERPROFILE\.studio"       # should contain cli.json, shared.json
ls "$env:USERPROFILE\Studio\sites"  # your local sites

Windows
│
├── %APPDATA%\Claude\
│   └── claude_desktop_config.json     ← Claude Desktop MCP config
│
├── %USERPROFILE%\.claude\
│   └── settings.json                  ← Claude Code CLI MCP config
│
├── %USERPROFILE%\.studio\
│   ├── cli.json                        Local site registry
│   ├── shared.json                     WordPress.com OAuth token, locale
│   └── app.json                        Electron app data
│
└── %USERPROFILE%\Studio\sites\
    └── {site-name}\
        ├── wp-config.php
        └── wp-content\
            ├── database\
            │   └── .ht.sqlite          SQLite database (db_* tools)
            ├── plugins\
            ├── themes\
            └── debug.log               PHP error log (fs_read_error_log)

wordpress-studio-mcp/
├── src/
│   ├── index.ts                  MCP server entry point (stdio transport)
│   ├── studio-config.ts          Reads ~/.studio/cli.json, path safety guard
│   └── tools/
│       ├── site-registry.ts      studio_registry, studio_daemon_status …
│       ├── filesystem.ts         fs_read_file, fs_write_file, fs_find_files …
│       ├── database.ts           db_query, db_execute, db_export_sql …
│       ├── wpcli.ts              wpcli_plugin_list, wpcli_run …
│       ├── rest-api.ts           wpcom_api_get, wp_rest_get, wpcom_mcp_call, wpcom_theme_context …
│       ├── blueprints.ts         studio_blueprint_list, studio_blueprint_generate, studio_blueprint_apply
│       └── vip-design.ts         vip_design_tokens, vip_design_theme_json
│
├── dist/                         Compiled JS — generated by npm run build
├── .claude-plugin/
│   ├── plugin.json               Claude Code plugin metadata
│   └── marketplace.json          Marketplace registration
├── .mcp.json                     MCP definition for Claude Code plugin system
├── setup.ps1                     One-command Windows setup
├── package.json
└── tsconfig.json

npm run dev    # watch mode — tsx, no build step
npm run build  # compile TypeScript → dist/
npm run clean  # remove dist/