wpagent-mcp

wpagent-mcp

一个 MCP 服务，让 Claude 或任何兼容 MCP 的客户端都能实际操作 WordPress 网站：插件、内容、主题、菜单、媒体、用户、WooCommerce、Elementor 和 WP-CLI。

它通过免费的 WpAgent 桥接插件与您的网站通信，使用 REST API，且每个请求都通过 HMAC-SHA256 签名。无需提供网站凭据，也不会有任何数据经过第三方服务：连接路径为客户端 → 您的 WordPress，直接连接。

安装

无需预先安装任何内容——下方配置会按需获取。

1. 在您的 WordPress 网站上安装并启用 WpAgent 插件。
2. 在 WordPress 管理后台中打开 WpAgent 并生成 API 密钥。选择您希望助手拥有的权限；只读密钥是不错的起步选择。
3. 将服务添加到您的 MCP 客户端。对于 Claude Desktop，在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "wpagent": {
      "command": "npx",
      "args": ["-y", "wpagent-mcp"],
      "env": {
        "WP_SITE_URL": "https://your-site.com",
        "WP_API_KEY_ID": "wpaia_xxxxxxxxxxxx",
        "WP_API_SECRET": "the secret shown once when you generated the key"
      }
    }
  }
}

对于 Claude Code：

claude mcp add wpagent \
  --env WP_SITE_URL=https://your-site.com \
  --env WP_API_KEY_ID=wpaia_xxxxxxxxxxxx \
  --env WP_API_SECRET=... \
  -- npx -y wpagent-mcp

环境变量

变量	必填	说明
WP_SITE_URL	是	您网站的基础 URL，不带末尾斜杠
WP_API_KEY_ID	是	插件中显示的密钥 ID
WP_API_SECRET	是	生成时仅显示一次的密钥
WP_SITE_LABEL	否	易于识别的名称；默认使用主机名

功能

类别	示例
插件	列出、搜索 wordpress.org、安装、启用、停用、更新、删除
内容	文章、页面、产品、任何自定义文章类型，支持元数据和特色图片
主题	列出、搜索、安装、启用、主题设置、自定义 CSS、徽标、颜色
WooCommerce	设置、订单、优惠券、配送区域、支付网关、税率、统计数据
结构	菜单、小工具、侧边栏、分类法、分类项、重定向
媒体	浏览、上传、删除
用户和评论	列出、创建、更新、审核
审计	检查安全、SEO、性能方面的最佳实践，并自动修复
WP-CLI	允许列表中的命令；除非在 wp-config.php 中启用，否则处于关闭状态

不会执行的操作

该 API 无法访问任意 PHP、数据库或 wp-config.php。除非网站所有者在服务器上添加 define('WPAIA_ENABLE_WPCLI', true);，否则 WP-CLI 执行处于禁用状态；即使启用，也只会运行允许列表中的命令——db、eval、eval-file、shell、server、config 和 package 始终会被拒绝。

安全性

• 每个请求都使用 HMAC-SHA256 签名并附带时间戳；超过五分钟的请求会被拒绝。
• 每个密钥都有独立权限，并且每个路由都会检查权限，因此只读密钥始终保持只读。
• 每次调用都会写入审计日志，您可以在 WordPress 管理后台查看。
• 在 WordPress 中撤销密钥后会立即生效。

请让助手在执行破坏性操作前先确认，并保持备份为最新状态——如果您要求，它可以删除内容。

相关项目

• WpAgent — 基于同一桥接插件构建的托管式仪表盘，提供免费的只读套餐
• 桥接插件采用 GPL-2.0-or-later 许可；此服务采用 MIT 许可。

许可

MIT © KipDev