WordPress MCP Adapter (Official)

什么是 WordPress MCP Adapter (Official)？

WordPress MCP Adapter (Official) 是 WordPress 项目官方的 wordpress mcp 插件：它把通过 WordPress Abilities API 注册的能力（abilities）转换为 MCP 工具、资源和提示词，供 Claude、Cursor、VS Code 等 AI 客户端调用。

该适配器属于 AI Building Blocks for WordPress 计划，代码位于 WordPress/mcp-adapter，采用 GPL-2.0-or-later 许可，同时以 “MCP Adapter” 之名收录在 WordPress.org 插件目录中。它要求 WordPress 6.9 或更高版本（Abilities API 已并入核心）。它取代了 Automattic 早先的 wordpress-mcp 插件，后者现已归档，并引导用户转到本仓库。

如何使用 WordPress MCP Adapter (Official)？

前提条件：WordPress 6.9+、PHP 7.4+；如果用 Application Password 连接，站点需要启用 HTTPS（除本地站点外，WordPress 只在 HTTPS 下提供 Application Password）。使用代理的桌面客户端还需要安装 Node.js。

1. 安装并启用插件。使用 WP-CLI：

wp plugin install https://github.com/WordPress/mcp-adapter/releases/latest/download/mcp-adapter.zip --activate

插件会在 /wp-json/mcp/mcp-adapter-default-server 创建一个默认的 WordPress MCP 服务器，路径拼接在站点地址之后（例如 https://example.com/wp-json/mcp/mcp-adapter-default-server）。

2. 在 用户 > 个人资料 > Application Passwords 中，为 AI 助手所代表的用户创建一个 Application Password。建议使用一个单独的、权限尽可能低但足以完成工作的用户。

Claude Desktop、Cursor、VS Code 和 Windsurf

大多数桌面客户端会启动 @automattic/mcp-wordpress-remote 代理，它把 STDIO 消息通过 HTTP 转发到你的站点。在 Claude Desktop 中打开 Settings > Developer > Edit Config；在 Cursor 中编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "my-wordpress-site": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://example.com/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "your-username",
        "WP_API_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

保存后重启应用。对于提供相应机制的站点，该代理还支持 OAuth（OAUTH_ENABLED=true）和 JWT 令牌（JWT_TOKEN）。

Claude Code

Claude Code 可以通过 HTTP 直接连接，并携带 Basic 认证头。把 username:application-password 编码为一行 base64，然后添加服务器：

printf 'your-username:xxxx xxxx xxxx xxxx xxxx xxxx' | base64 | tr -d '\n'

claude mcp add --transport http my-wordpress-site \
  https://example.com/wp-json/mcp/mcp-adapter-default-server \
  --header "Authorization: Basic PASTE_THE_BASE64_HERE"

通过 WP-CLI 连接本地站点（STDIO）

如果 WordPress 运行在你自己的电脑上，客户端可以通过 WP-CLI 直接启动适配器，无需密码：

{
  "mcpServers": {
    "wordpress": {
      "command": "wp",
      "args": [
        "--path=/path/to/your/wordpress/site",
        "mcp-adapter",
        "serve",
        "--server=mcp-adapter-default-server",
        "--user=admin"
      ]
    }
  }
}

wp mcp-adapter list 可列出已注册的服务器。

可以用这样的提示词测试连接：“List the WordPress abilities you can use on my site.”（列出你在我站点上可以使用的 WordPress 能力。）

WordPress MCP Adapter (Official) 的主要功能

• WordPress 官方包，由 WordPress GitHub 组织维护，并通过 WordPress.org 分发
• 自动把 Abilities API 中的能力转换为 MCP 工具、资源和提示词
• 支持 HTTP 传输（MCP Streamable HTTP，使用 Mcp-Session-Id 会话）以及通过 wp mcp-adapter serve 的 STDIO 传输
• 默认私有：只有标记了 meta.public（或 meta.mcp.public）的能力才能被访问
• 每次调用都以某个 WordPress 用户身份执行，角色和权限照常生效
• 每个站点可运行多个 MCP 服务器，各自拥有独立的传输方式、能力和权限检查
• 可插拔的错误处理和可观测性接口，并支持自定义传输
• 开发者可通过 Requires Plugins: mcp-adapter 声明依赖；也可使用 composer require wordpress/mcp-adapter，但官方不建议打包内置

WordPress MCP Adapter (Official) 工具

无论站点上有多少能力，默认服务器都只暴露三个元工具，使 tools/list 保持精简：

• 发现： mcp-adapter-discover-abilities 列出公开能力的名称、标签和描述。
• 查看： mcp-adapter-get-ability-info 返回单个能力的输入和输出 schema。
• 执行： mcp-adapter-execute-ability 在确认能力为公开并运行其自身权限回调后，带参数执行该能力。

助手实际能做什么（创建草稿、读取站点信息等）取决于 WordPress 核心和你的插件注册了哪些能力。希望每个能力对应一个独立 MCP 工具的开发者，可以通过 mcp_adapter_init 钩子创建自定义服务器。

WordPress MCP Adapter (Official) 的使用场景

• 借助注册了能力的插件处理内容：“Create a draft post titled 'Fall menu' with this text.”（用这段文字创建一篇标题为 “Fall menu” 的草稿。）
• 让 Claude Code 或 Cursor 通过 WP-CLI STDIO 在本地站点上测试插件的能力
• 插件开发者无需单独编写 MCP 服务器，即可把功能开放给 AI 智能体
• 代理机构通过一个编辑（Editor）级别的用户，为助手提供受限的客户站点访问权限
• 审查站点对外暴露了什么：“Which abilities are public on this site, and what inputs do they take?”（这个站点有哪些公开能力？它们需要哪些输入？）

WordPress MCP Adapter (Official) 与替代方案对比

• Automattic wordpress-mcp： 早先的插件，现已归档；Automattic 的说明引导用户改用 MCP Adapter。
• 社区版 WordPress MCP 服务器： 例如 mcp-wordpress（docdyhr）和 WordPress MCP Server（prathammanocha），它们作为 Node.js 服务器运行在 WordPress 之外，用 Application Password 调用 REST API，因此自带一组固定工具，不依赖站点上注册的能力。而适配器运行在 WordPress 内部，只暴露插件注册的内容。

WordPress MCP Adapter (Official) 常见问题排查

• 401 Unauthorized： 使用登录名或邮箱（而不是显示名称），确认 Application Password 完整复制且未被撤销；在部分 Apache 环境下，需要请主机商把 Authorization 头传递给 PHP。
• 404 或 rest_no_route： 确认插件已启用。如果使用“朴素”固定链接，请改用 https://example.com/?rest_route=/mcp/mcp-adapter-default-server。
• 已连接但无事可做： 在插件把能力标记为公开之前，能力列表是空的；请安装支持 Abilities API 的插件。
• npx: command not found： 安装 Node.js 后重启客户端。
• Missing Mcp-Session-Id header： HTTP 客户端必须先发送 initialize，并在后续请求中带上返回的会话 ID。