想象一下，如果你的编码代理能够直接在浏览器中读取WordPress文件、执行PHP并管理网站，那将是多么高效的工作方式！这正是WordPress Playground MCP（模型上下文协议）软件包带来的核心能力——它将AI编码代理与基于浏览器的Playground实例无缝桥接。你只需运行一个简单的命令即可建立连接，在Playground里完全不需要额外配置。@wp-playground/mcp
工作原理
WordPress Playground MCP服务器以本地Node.js进程的形式运行，采用stdio作为传输协议。你的AI客户端直接与该服务器通信，而服务器则通过WebSocket连接将命令转发到浏览器中运行的Playground实例。整个过程简洁高效。
AI Client (stdio) --> MCP Server (Node.js) --> WebSocket --> Browser (Playground)当你在浏览器中打开Playground时，一个WebSocket连接会将浏览器标签页链接到MCP服务器。服务器在启动时会分配一个随机的本地端口，并通过URL参数（即mcp-port）传递给浏览器。随后，服务器会将代理发出的工具调用直接转换为操作Playground的具体指令：读取文件、执行PHP代码以及导航页面，所有动作都一目了然。
整个连接过程始终保持在你的机器本地，从未离开你的控制。启动时的来源限制策略和基于令牌的身份验证机制，有效防止了其他网站或浏览器扩展的未授权访问，确保了安全性。
搭建MCP服务器
克劳德密码
claude mcp add --transport stdio --scope user wordpress-playground -- npx -y @wp-playground/mcp这里的--scope user标志可以让该服务器在你所有项目中都能使用。如果你只想限制在当前项目中，可以使用--scope local。根据实际需求灵活选择即可。
Gemini CLI
gemini mcp add wordpress-playground npx -y @wp-playground/mcp默认使用的传输方式是stdio。如果你想设置用户作用域，可以通过-s user参数来指定范围。
JSON 配置
当然，你也可以选择手动配置服务器。只需将以下内容添加到你的.mcp.json文件中（适用于Claude Code或Claude Desktop）：
{ "mcpServers": { "wordpress-playground": { "type": "stdio", "command": "npx", "args": ["-y", "@wp-playground/mcp"] } }}需要注意的是，在Gemini CLI中，你需要在settings.json里使用相同的结构，但不能包含"type"字段。配置细节略有不同，请留意。
一切设置妥当后，在浏览器中打开Playground即可。当代理成功连接时，它会为你提供准确的访问URL，你便可以立即开始工作。
三种实用工作流程
连接成功后，你的AI代理就能通过自然语言与你对话，并直接管理WordPress站点了。以下三种工作流程非常实用，几乎涵盖了日常开发中的核心需求。
1. 安装、测试并构建插件
你完全可以请代理直接安装并验证插件，全程无需人工介入WordPress后台管理员界面。例如：
“在我的Playground网站上安装Classic Editor插件，确认它会禁用块编辑器。”
代理会通过playground_execute_php调用wp_remote_get，下载插件zip包，并将其解压到wp-content/plugins/目录下。接着，它使用activate_plugin()激活插件，然后通过playground_request对帖子编辑器的URL进行触发，以确认经典编辑器界面成功加载。每个步骤代理都会输出详细的结果，让你清楚地看到整个过程。
2. 用PHP调试站点选项
需要检查某个插件在数据库中wp_options表里存储了什么配置？完全不必打开管理员界面，直接让代理查询即可：
“给我看所有选项名中包含'woocommerce'的自动加载选项。”
代理会运行一个简短的playground_execute_php脚本来完成查询：
global $wpdb;$results = $wpdb->get_results( "SELECT option_name, option_value FROM $wpdb->options WHERE option_name LIKE '%woocommerce%'");print_r($results);需要特别留意的是，Playground默认使用SQLite而非MySQL，因此请避免在查询中使用专属于MySQL的列值。虽然$wpdb会为我们处理部分翻译工作，但像autoload = 'yes'这样的过滤条件可能无法按预期返回结果，需要适当调整。
查询结果会直接显示在你的对话窗口中，完全不需要额外启动phpMyAdmin或数据库客户端，极其方便。
3. 支架主题文件
当你需要从零开始构建一个子主题时，通常涉及创建目录、编写模板文件、注册主题等一系列繁琐操作。现在，你只需要把需求告诉代理，它就能帮你处理模板。例如：
“创建一个名为'Studio Child'的Twenty Twenty-Five子主题，带有自定义的标题模板部分和首页模板。”
代理会调用playground_mkdir创建主题目录，使用playground_write_file生成style.css、theme.json等模板文件，最后通过playground_execute_php验证主题是否成功出现在管理后台中。如果生成的文件存在错误，代理还会读取错误信息并自动在下一步中修正，整个过程无需你手动干预。
