WordPress MCP Adapter：让 WordPress 成为 AI Agent 的"技能超市"

一、项目背景与起源

如果把 WordPress 比作一座图书馆，那么 MCP Adapter 就是图书馆的"智能管理员"——它让 AI 代理（Claude、Cursor 等）能够像读者咨询管理员一样，精准地查找和调用 WordPress 的一切功能：查询文章、发布内容、管理用户、修改主题……

这个项目来自 WordPress AI Building Blocks 计划，由 WordPress 官方 AI 团队（make.wordpress.org/ai）主导开发维护，定位为 WordPress 接入 Model Context Protocol（MCP）生态的官方桥梁。MCP 是一种新兴的 AI 代理通信协议，旨在让不同 AI 工具（如 Claude Desktop、Cursor）能够统一地调用外部系统的工具和数据，WordPress 是首批接入 MCP 协议的内容管理平台之一。

核心贡献者包括 galatanovidiu（35 commits）、justlevine（17 commits）、jonathanbossenger（15 commits）等，均为 WordPress 核心团队成员，项目于 2025 年持续活跃迭代，当前版本 0.5.0。

图1：WordPress 官方组织标志（来源：GitHub）

二、核心功能：三层转换架构

MCP Adapter 的核心价值在于双向翻译：WordPress Abilities API 提供的能力被转换为 MCP 协议的三大组件。开发者只需注册一个 ability，标记 meta.mcp.public = true，AI 就能自动发现和调用它。

1. WordPress Abilities → MCP 组件

2. 双传输协议支持

• HTTP Transport：通过 WordPress REST API（/wp-json/mcp/mcp-adapter-default-server）暴露 MCP 端点，配合 @automattic/mcp-wordpress-remote 代理支持远程 AI 客户端
• STDIO Transport：通过 WP-CLI 命令行接口提供本地通信，适合 Claude Code、VS Code 等本地 AI 工具直连

3. 默认服务器开箱即用

安装即激活，自动创建默认 MCP 服务器，AI 通过 mcp-adapter/discover-abilities 动态发现所有可用能力。

三、代码架构：清晰的分层设计

includes/├── Core/           # 注册表与服务器管理
│   ├── McpAdapter.php    # 单例主类，钩子 mcp_adapter_init
│   ├── McpServer.php     # 单个 MCP 服务器配置
│   ├── McpComponentRegistry.php  # 组件实例存储
│   ├── McpTransportFactory.php    # 传输层工厂
│   └── McpVersionNegotiator.php  # 协议版本协商
│   ├── Abilities/        # 内置元 abilities
│   ├── Cli/             # WP-CLI 命令
│   └── Domain/          # 业务逻辑与 MCP DTO 模型
│       ├── Tools/        # 工具注册、执行、验证
│       ├── Resources/     # 资源注册、读取、验证
│       ├── Prompts/       # 提示模板构建
│       └── Utils/         # 名称清洗、Schema 转换
│   ├── Handlers/        # JSON-RPC 请求处理器
│   ├── Transport/       # 协议传输层（HTTP + STDIO）
│   └── Infrastructure/  # 错误处理 + 可观测性（可插拔）

**架构亮点：**全插件化设计，错误处理与可观测性均可替换；严格的类型安全（依赖 wordpress/php-mcp-schema）；完善的单元测试 + PHPStan 静态分析覆盖。

四、上手门槛与安装方式

安装（WP-CLI 一键）：

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

接入 AI 客户端：在 Claude Desktop 等支持 MCP 的客户端配置中，添加服务器配置（STDIO 或 HTTP），即可开始对话式管理 WordPress。

五、局限性与挑战

1. 依赖 WordPress 6.9+，老站点无法使用
2. HTTP 传输需额外配置 @automattic/mcp-wordpress-remote 代理
3. WordPress Abilities API 生态尚在成熟，可用的原生 abilities 数量有限
4. 无图形化管理界面，完全依赖 CLI 或 API

六、行业意义

WordPress 占据全球约 43% 的网站份额，作为首批大型 CMS 平台的 MCP 实现，WordPress 官方主导的 MCP Adapter 将推动 AI Native 内容创作生态的快速发展——AI Agent 可以直接理解网站结构，按指令生成文章、调整主题、管理插件，无需复杂的 API 对接。

项目链接：WordPress/mcp-adapter
Star 数：1,265 ⭐ 许可证：GPL-2.0-or-later 主要语言：PHP 当前版本：v0.5.0