Wordpress Studio MCP

WordPress工作室MCP

让Claude直接访问您的本地WordPress网站-读取文件，查询数据库，运行WP-CLI，调用WordPress REST API，并检查网站状态。四组件AI驱动的WordPress开发堆栈的一部分。

 ](https://nodejs.org) ](https://github.com/movinginfo/wordpress-studio-mcp/releases)   ](https://github.com/movinginfo/wordpress-studio-mcp)

______________________________________________________________________

目录

• 完整的WordPress AI堆栈
• 安装--克劳德桌面
• 安装--Claude代码集成开发环境
• wpstudio CLI--终端使用
• wordpress工作室mcp工具（58）
• wordpress工作室工具（13）
• WP-CLI参考
• wordpress.com MCP工具（17）
• wordpress.com插件命令
• 环境变量
• 关键路径
• 安全
• 故障排除

______________________________________________________________________

完整的WordPress AI堆栈

四个组件协同工作。安装所有四个以获得完整体验。

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

总计：4个命令+91个MCP工具 涵盖整个WordPress开发生命周期。

______________________________________________________________________

需求

______________________________________________________________________

安装--克劳德桌面

步骤1--克隆和构建

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

第二步——编辑 claude_desktop_config.json

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"]
    }
  }
}

替换 YourName 使用您的实际Windows用户名。

步骤3--安装wordpress.com插件

克劳德桌面→ 设置→ 连接器→ 浏览插件 → 搜索 “wordpress.com” → 安装。

这增加了 /design-site, /preview-designs, /quick-build, /site-specification 命令和遥控器 wordpress-com MCP（17个工具）具有自动OAuth 2.1登录功能。

步骤4--重新启动并验证

完全退出Claude Desktop（系统托盘→ 退出）并重新打开。点击 ⊕插头图标 在聊天输入中：

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

______________________________________________________________________

安装--Claude代码集成开发环境

步骤1--克隆和构建

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

步骤2——注册MCP服务器

# 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

步骤3--安装wordpress.com插件

打开克劳德代码→ 插件面板→ 浏览→ “wordpress.com” → 安装。

或者从终端：

claude plugins install wordpress.com

步骤4——验证

claude mcp list

类型 /mcp 在Claude Code内部——所有服务器都应该显示绿色。类型 / 查看可用命令。

备选方案--编辑 ~/.claude/settings.json 直接

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

添加内部 mcpServers:

{
  "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"
    }
  }
}

______________________________________________________________________

安装--VS代码+GitHub复制品

需要 VS代码1.99+ 和那个 GitHub Copilot 扩展。注册服务器的三种方法——选择适合你的。

步骤1——克隆和构建（与上述相同）

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

步骤2——注册MCP服务器

选项A——命令选项板（最简单）

Ctrl+Shift+P → MCP：添加服务器 → 选择 标准 → 输入：

VS Code将条目写入您的用户 settings.json 自动。

______________________________________________________________________

选项B-- .vscode/mcp.json （工作空间级别）

创建 .vscode/mcp.json 在任何项目文件夹中：

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

仅在该工作区中处于活动状态。可以致力于源代码控制，以便队友自动获得它。

______________________________________________________________________

选项C-- settings.json （全局，所有工作区）

Ctrl+Shift+P → 打开用户设置（JSON） → add:

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

步骤3——验证

1. 打开Copilot聊天-- Ctrl+Alt+I
2. 切换至 代理模式 （聊天输入旁边的下拉菜单）
3. 点击 工具图标 --全部 wordpress-studio-mcp 应列出工具
4. 问： list my WordPress Studio sites

______________________________________________________________________

wpstudio CLI--终端使用

直接从VS Code集成终端、PowerShell或bash调用71个MCP工具中的任何一个——不需要AI客户端。

安装

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

仅限首次——将npm全局bin添加到PATH （PowerShell，运行一次）：

$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 将无处不在。

命令

wpstudio list                              # all 71 tools grouped by category
wpstudio help                        # 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'

工具命名

MCP工具名称(studio_registry, wpcli_plugin_list)成为CLI子命令，下划线被连字符替换(studio-registry, wpcli-plugin-list).跑 wpstudio list 查看全部71。

______________________________________________________________________

工具参考

wordpress-studio-mcp ·57工具·这个项目

站点注册表和状态

文件系统

SQLite数据库

WP-CLI助手

WordPress.com远程API

需要WordPress.com OAuth令牌 ~/.studio/shared.json （通过Studio Desktop登录）。

本地站点WP REST API

在运行的Studio站点上直接调用WordPress REST API(http://localhost:{port}/wp-json/).支持WordPress应用程序密码进行写访问。

主题设计代币

在生成块内容之前使用这些内容，以与网站的视觉设计保持一致——使用预设的slug（例如。 has-primary-color, has-large-font-size)而不是硬编码的十六进制/px值。

内容生成前的推荐顺序：

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

WordPress.com MCP代理

示例——调用官方统计工具：

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

蓝图

创建可复制Studio站点的JSON配方。与WordPress Playground格式相同——可跨开发环境移植。

自定义域映射

绘制一个真实的域（例如。 testmysite.com)转到本地Studio网站，以便它以以下方式打开 http://testmysite.com 而不是 http://localhost:8883。在本地复制实时网站时必不可少——保持所有WordPress URL、媒体路径和重定向的一致性。

它是如何工作的（从 自动机/工作室 来源）：

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 ✓

解决方案——4个自动步骤：

用途：

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

使用 confirmed: false 首先预览所有步骤而不应用。

最后一步——Windows主机文件（需要管理员）：

写信给 C:\Windows\System32\drivers\etc\hosts 需要更高的特权。如果自动写入失败，请打开 PowerShell作为管理员 并运行：

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中的网站（停止→ 开始）
2. 打开 http://testmysite.com 在浏览器中
3. 网站加载时就像在真实域上运行一样

工作流程——将实时网站复制到工作室：

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

使用真实域名的HTTPS(studio_site_use_mkcert)

问题——在Studio UI中单击“启用HTTPS”时会发生什么：

Studio的内置证书颁发机构（CA）具有X.509 名称约束 将其限制为 .local 仅限域名。当您在Studio设置中为以下网站启用HTTPS时 i-help.us，Studio会自动更改网站URL https://i-help.us 到 https://i-helpus.wp.local:

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

WordPress地址和网站地址 wp-admin → Settings → General 也变了。开场 https://i-help.us Chrome显示 ERR_CERT_INVALID --Chrome拒绝证书 CERT_TRUST_HAS_NOT_PERMITTED_NAME_CONSTRAINT.

这意味着：您不能对真实域名使用Studio的内置HTTPS切换。

解决方案-- mkcert:

mkcert创建本地CA 无名称限制 并将其安装到Windows/Chrome/Firefox信任存储中。生成的证书对任何域名都是浏览器信任的。

不要在Studio UI中为真实域站点启用HTTPS。 使用 studio_site_use_mkcert 相反。

步骤1--安装mkcert （不需要winget/choco——单个.exe文件）：

*Windows--以管理员身份打开PowerShell：*

# 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

*macOS-在终端中：*

brew install mkcert nss

或者使用附带的脚本： ./https-certificates/setup-https-macos.sh i-help.us

步骤2——运行MCP工具：

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

该工具自动执行的操作：

步骤3--在Studio中重新启动站点 → open https://i-help.us → 绿色挂锁✅

故障排除：

完整的手动和自动化脚本： https-certificates/

Xdebug

Xdebug WordPress Studio网站的步骤调试，由PHP-WASM提供支持。连接VS Code或PhpStorm，使用断点调试插件、主题和核心代码。

工作室限制：

• 仅 一个站点 可以一次启用Xdebug——在第二个站点上启用会自动禁用第一个站点
• Xdebug 减慢PHP速度 --非主动调试时禁用
• Xdebug端口： 9003 |服务器路径： /wordpress → 磁盘上的站点文件夹

快速工作流程：

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

VS代码 launch.json （自动生成）：

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

PhpStorm服务器设置：

• 主持人： localhost ·端口： 8883 （您的站点端口）
• 路径映射：站点文件夹→ /wordpress （服务器上的绝对路径）
• 启用“开始监听PHP调试连接”

参考： WordPress Studio中的Xdebug

WordPress能力API和MCP适配器

它是如何工作的：

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

运输方式 (via 参数）：

• auto --先尝试HTTP（MCP适配器端点），然后回退到WP-CLI eval
• http --仅使用HTTP JSON-RPC（需要安装适配器+应用程序密码）
• wpcli --直接使用WP-CLI eval（无需HTTP身份验证，无需适配器插件即可工作）

安装工作流程：

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

注册自己的能力 （在WordPress插件或functions.php中）：

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];
    },
]);

MCP适配器端点位于：

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

它公开了三个内置的元工具-- mcp-adapter/discover-abilities, mcp-adapter/get-ability-info, mcp-adapter/execute-ability --无论存在多少能力，都要保持AI上下文的干净。

注： 需要WordPress 6.8+、PHP 7.4+和Composer（用于供应商依赖关系）。使用 via:wpcli 作为HTTP适配器尚未安装时的回退。

Claude Code的营销技巧

安装34种久经考验的营销技巧 直接进入克劳德代码。技能涵盖首席风险官、文案撰写、搜索引擎优化、付费广告、分析、增长工程和收入运营——通过以下方式激活 /skill-name 在任何Claude Code会话中。

类别：

工作流程：

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

提示： 技能安装到 global 每个项目都有范围。使用 project 将团队特定配置的范围签入源代码管理。

______________________________________________________________________

行政与安全

衍生工具 WordPress高级管理手册.涵盖强化、配置管理、备份、cron和更新。

常见硬化工作流程：

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

VIP设计系统

Automattic自己的设计系统()--WordPress.com、VIP和Jetpack中使用的相同令牌/组件库。基于主题UI+基数UI构建。

调色板： 10个调色板×每个调色板12个按键。语义角色： primary, foreground, background, muted, border, success, warning, danger, info, link.

排版： 12步响应量表 clamp() --xs到5xl（显示）。字体系列：系统UI（主体）、Recoleta（衬线）、继承（标题）、等宽字体。

VIP DS的设计工作流程：

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

27个支持的蓝图步骤：

蓝图示例：

{
  "$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 } }
  ]
}

______________________________________________________________________

wordpress-studio ·13工具·Automattic(wp-studio@1.7.7)

实施说明（来自Studio 1.7.7源代码）：

• validate_blocks 和 take_screenshot 使用 剧作家/铬 --站点必须正在运行
• wp_cli 之前自动验证块内容 post create/update --post_content=…
• 自动登录URL模式： {siteUrl}/studio-auto-login?redirect_to=/wp-admin/post-new.php
• 用途 @anthropic-ai/claude-agent-sdk (createSdkMcpServer)内部，非原始MCP SDK
• 技能被安装到 .agents/skills/{id}/ 带有来自的符号链接 .claude/skills/{id}/
• STUDIO.md 每次打开时，每个网站根目录都会自动更新

此插件和官方插件之间的功能划分 wordpress-studio

这两台服务器是互补的——为整个堆栈安装两台服务器。

______________________________________________________________________

WP-CLI参考

WP-CLI是WordPress的命令行界面。通过使用它 wpcli_run 工具（任何命令）或上面的特定辅助工具。在Studio中，WP-CLI通过PHP-WASM运行，不需要单独安装WP-CLI。

文件： developer.wordpress.com/docs/developer-tools/studio/cli

常见命令通过 wpcli_run

站点信息

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

WooCommerce（安装时）

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

搜索替换工作流（URL迁移）

始终先进行干洗，然后涂抹：

# 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"

______________________________________________________________________

wordpress.com MCP·17工具·Automattic（远程HTTP）

远程WordPress.com MCP连接到 public-api.wordpress.com 通过OAuth 2.1（PKC）。它管理 托管WordPress.com网站 --不是本地工作室网站。

文件： developer.wordpress.com/docs/mcp/tools-reference

写入/删除工具

所有写入和删除操作都通过一个统一的工具进行： wpcom-mcp-content-authoring

安全协议： 每次写入操作都需要一个强制性的确认步骤。代理人必须描述行为，要求明确确认，并包括 user_confirmed: true 在params中。写入操作从不自动执行。

内容创作操作

使用模式：

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)

提示： 在创建内容之前，获取 theme.presets 从 wpcom-mcp-site-editor-context 首先——使用预设的蛞蝓（例如。， has-primary-color, has-large-font-size)而不是硬编码hex/px值，这样内容就能适应主题的变化。

______________________________________________________________________

只读工具

wpcom-mcp-site-editor-context

查询活动主题的设计标记：调色板、字体大小、字体族、渐变、间距比例和每块样式替代。在创建内容之前使用，以与网站的视觉设计保持一致。

推荐顺序： theme.active → theme.presets → blocks.allowed → 创作内容

wpcom-mcp-posts-search

按查询、类型、状态、作者、类别、标签、日期范围和自定义字段跨站点搜索帖子。返回ID、标题、内容、摘录、永久链接、作者、类别、标签。

wpcom-mcp-post-get

通过ID或URL检索单个帖子。可以在响应中包含评论。

wpcom-mcp-site-comments-search

在网站内搜索评论。按状态（已批准/待处理/垃圾邮件/垃圾）、帖子ID、作者、日期范围过滤。返回线程化注释结构。

wpcom-mcp-site-plugins

列出已安装的插件，包括状态、版本、作者、更新可用性。按活动/非活动/全部筛选。

wpcom-mcp-site-settings

获取网站配置：常规设置、写作、阅读、讨论、媒体大小、永久链接结构、隐私。控制包含哪些部分以减少响应大小。

wpcom-mcp-site-statistics

网站流量数据：浏览量、访问者、热门帖子/页面、推荐人、地理细分、设备类型。支持日/周/月/年周期，最多可回溯365个周期。

wpcom-mcp-user-sites

列出您的所有WordPress.com网站，包括过滤（搜索、状态、隐私、自定义域）和可选指标（视图、帖子、存储、健康评分）。

wpcom-mcp-site-users

列出特定网站上的用户，包括角色、权限、可选电子邮件、上次登录和帖子计数。

wpcom-mcp-user-profile

您的WordPress.com个人资料：基本信息、偏好、帐户统计、计划/订阅、社交参与、活动指标。只要求你需要的部分。

wpcom-mcp-user-connections

社交整合（推特/X、脸书、领英等）：状态、能力、上次测试。

wpcom-mcp-user-notifications

通知渠道设置（电子邮件、推送、时间线）和注册设备。

wpcom-mcp-user-notifications-inbox

通知收件箱：按类型（如/关注/评论/提及/成就）、仅未读或日期范围过滤。

wpcom-mcp-user-security

2FA状态、活动会话、应用程序密码、登录历史记录（最多90天）。

wpcom-mcp-user-subscriptions

计划和计费：订阅详细信息、计费历史、付款方式、存储/带宽使用情况。

wpcom-mcp-user-achievements

徽章、功绩、进度跟踪、奖杯箱。

______________________________________________________________________

wordpress.com 插件·命令·自动机（技能）

安装：克劳德代码→ 插件面板→ 浏览→ “wordpress.com”

无MCP服务器——使用Studio CLI和文件系统工具的纯Claude代理工作流。

/site-specification

从简单的英文网站描述中提取结构化规范。输出：

{
  "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=..."
  }
}

按网站类型推断排版：

/preview-designs

生成三个不同的HTML设计方向(design-1.html, design-2.html, design-3.html)在浏览器中打开。每个都有内联CSS、谷歌字体、无外部依赖、WCAG 4.5:1对比度和 prefers-reduced-motion 支持。三个选项的色温、排版声音和英雄布局各不相同。

/design-site

从简短到部署的WordPress块主题的完整多阶段AI编排：

设计令牌一旦设置就不可变。仅限核心模块——否 wp:html 后退。主题slug必须匹配 ^[a-z0-9-]+$.

/quick-build

最快路径：描述→ 部署站点。

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

______________________________________________________________________

安全

• 路径沙盒 --所有文件系统工具都会验证解析的路径是否在内部 STUDIO_SITES_ROOT。在服务器级别阻止了目录遍历。
• 秘密编辑 — wp-config.php 密码、密钥和盐在输出前被剥离。配置转储会编辑所有匹配的字段 password, token, key, secret，或 salt.
• 只读SQL — db_query 拒绝任何不以开头的陈述 SELECT 或 WITH.写入通过 db_execute 明确地。
• 没有本机二进制文件 --使用内置的Node.js node:sqlite （自v22.5以来稳定）。没有Python，没有 node-gyp.
• WordPress.com写安全 — wpcom-mcp-content-authoring 需要 user_confirmed: true 在每次写入/删除调用中。永久删除（类别、标签）还需要 confirm_permanent_delete: true.
• REST API写入安全 — wpcom_api_post 和 wp_rest_request 需要 confirmed: true 在每一个变异的呼叫中。不会自动执行任何写入操作。
• 应用程序密码 -本地REST API验证使用WordPress应用程序密码（WordPress 5.6+）。在WP Admin中生成→ 用户→ 简介→ 应用程序密码。切勿传递普通登录密码。

______________________________________________________________________

故障排除

______________________________________________________________________

发展

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

______________________________________________________________________

相关

• VIP设计系统 --Automattic的设计令牌和React组件（主题UI+Radix UI）
• wordpress.com克劳德插件 --官方Automattic技能插件
• WordPress工作室 --本地WordPress开发环境
• wp-studio命令行界面 --官方Studio CLI npm包（v1.7.7）
• Studio CLI文档 --完整CLI参考
• WordPress.com MCP工具参考 -完全远程MCP API
• WP-CLI概述 --WP-CLI在WordPress.com上
• 模型上下文协议 --MCP规范

______________________________________________________________________

许可证

麻省理工学院 ©2026 movinginfo