前言:为什么需要 MCP Adapter
如果你希望用 AI(如 GPT/Claude/Codex)直接远程管理 WordPress 内容,MCP Adapter 提供了一个“统一的工具层”。它会把 WordPress Abilities API 暴露为 MCP 工具,模型就能通过标准协议调用具体能力(如创建文章、导入媒体、管理分类标签)。
一、安装准备
- WordPress 版本建议 6.8+(或已具备 Abilities API)。
- 已启用 Application Passwords(用于 API 身份验证)。
- 服务器可正常访问站点的 REST API:
/wp-json。
二、安装 MCP Adapter
- 在后台安装并启用 MCP Adapter 插件。
- 确保插件启用后能加载 Abilities API。
- 如果你有自定义能力(例如 Actions Bridge),确保也已启用并注册 abilities。
三、配置 MCP 服务
1. 本地(CLI)启动示例
wp mcp-adapter serve --server=mcp-adapter-default-server --user=你的用户名
建议使用 PHP 执行并设置内存限制:
php -d memory_limit=512M /path/to/wp mcp-adapter serve --server=mcp-adapter-default-server --user=你的用户名
2. MCP 客户端配置
在 MCP 客户端配置中填入:
- server:
mcp-adapter-default-server - host/transport:使用 STDIO 或 HTTP(视你的接入方式)
- 鉴权:Basic Auth(Application Password)
四、常见坑与排查
- 看不到能力:确保 abilities 已注册,且 MCP Adapter 已重启。
- 执行失败:检查当前用户权限(需具备编辑文章权限)。
- Schema 不完整:确认 Actions Bridge 的设置已保存,并重新生成 Schema。
- 接口超时:提高 PHP memory_limit,或减少 schema 操作数量。
五、下一步建议
- 添加专用的 MCP Prompt 指令模板,让模型遵循你的流程。
- 先用“创建草稿”测试,再逐步扩展到媒体导入、分类标签管理。
- 为重要操作增加回读验证(getPost)确保数据正确写入。
如果需要,我可以继续提供“Actions Bridge + MCP Adapter”的完整实操流程与模板。



