SiteHelm

SiteHelm

一个运行于 WordPress 内的 MCP 服务，让 AI Agent 能够修改线上网站，而你可以查看、批准和撤销每项更改。

让 AI Agent 能够操作你的 WordPress 网站，同时让你事后仍能审计所有操作。

SiteHelm 是一款 WordPress 插件，可将你的网站作为 MCP 工具开放，让 Claude、Claude Code、Cursor、VS Code 以及其他 MCP 客户端编写内容、构建 Elementor 页面、管理媒体和菜单、编辑 ACF 和 Meta Box 字段、审核评论，并操作你已经在使用的 SEO 插件。每项更改都会在生效前预览、生效后验证、记录日志，并且可以撤销。

提示

SiteHelm Pro 面向 GitHub 社区优惠 7 折：在结账时使用代码 GITHUB30。该优惠适用于首次付款及每次续费。

功能

运营网站。 帖子、页面和自定义类型、媒体、菜单、评论、重定向、用户、网站设置、SEO 元数据、表单和条目，以及插件和主题清单——115 项类型化操作，通过 11 个 MCP 工具调用。每个工具都会在运行时返回自己的目录，而 system-operation-find 可根据自然语言查询搜索全部功能。

使用 Elementor 构建。 两个 Elementor 工具涵盖 37 项操作：文档、元素树、页面和容器设置、模板、全局颜色、排版与类，以及主题模板条件。

查看、批准并撤销。 每次写入都分为两次调用：预览不会写入任何内容，并会返回差异；随后执行的应用操作会绑定到该差异。引擎会在写入前创建快照，写入后读取网站内容，并将不匹配报告为失败，而非成功。每项更改都会记录在 wp-admin 的审计日志中，已应用的更改可从那里回滚。

支持你的插件。 ACF、Meta Box 和七款 SEO 插件通过一个调用接入，并按固定优先级处理，因此同一操作会通过网站正在使用的插件写入。Pro 版本还支持 WooCommerce 和 Elementor Pro。如果缺少某项集成，操作会拒绝执行并指出需要启用的插件。

Agent 使用具有严格输入架构的命名操作。它无法访问 PHP、SQL、Shell 或文件系统。

→ 完整操作参考 — 查看每项操作及其能力要求、风险级别和回滚策略。

安装

1. 从 Releases 下载最新的 sitehelm-*.zip。
2. 在 WordPress 中选择：插件 → 安装插件 → 上传插件，选中 zip 文件，安装并启用。
3. 打开 SiteHelm → 连接。该页面会显示端点、凭据以及客户端配置片段。

已安装的副本可通过 仪表盘 → 更新 原位更新。

要求： WordPress 6.6+ 和 PHP 8.1+。Elementor、ACF、Meta Box 和 WooCommerce 均为可选集成，而非必需项。只有 stdio 桥接需要 Node 18+。如果 PHP 或 WordPress 版本低于最低要求，插件会拒绝启动并显示提示，而不会触发致命错误。

连接你的 AI 客户端

端点如下：

POST https://your-site.com/wp-json/sitehelm/v1/mcp

连接页面提供两种接入方式。在应用中登录（仅限 HTTPS）：将端点粘贴到支持它的客户端中，在网站上批准即可，密码不会进入配置文件。应用程序密码：适用于所有客户端，以下代码片段使用这种方式。

无论选择哪种方式，该路由都需要已登录的 WordPress 用户，并且每项操作都会重新检查该用户的权限。Agent 只能执行该用户在 wp-admin 中手动操作也能执行的操作。

claude mcp add --transport http sitehelm https://your-site.com/wp-json/sitehelm/v1/mcp \
  --header "Authorization: Basic $(printf '%s' 'admin:xxxx xxxx xxxx xxxx xxxx xxxx' | base64)"

{
  "mcpServers": {
    "sitehelm": {
      "url": "https://your-site.com/wp-json/sitehelm/v1/mcp",
      "headers": {
        "Authorization": "Basic BASE64_OF_username:application_password"
      }
    }
  }
}

{
  "mcpServers": {
    "sitehelm": {
      "command": "node",
      "args": ["/path/to/wp-content/plugins/sitehelm/bridge/sitehelm-bridge.mjs"],
      "env": {
        "SITEHELM_ENDPOINT": "https://your-site.com/wp-json/sitehelm/v1/mcp",
        "SITEHELM_AUTH": "Basic BASE64_OF_username:application_password"
      }
    }
  }
}

请使用 HTTPS。通过普通 HTTP 发送应用程序密码，会导致凭据以明文形式传输。

默认安全

每项操作都会在处理程序中先执行已连接用户的 WordPress 权限检查，然后才会查找任何内容。此外：

• 先预览，再应用。 首次调用不会写入任何内容，并会返回每个字段修改前后的值以及一次性计划令牌。应用操作会绑定到这些确切参数；只要更改其中一个参数，操作就会被拒绝。你批准的差异，就是最终应用的差异。
• 快照并验证。 写入前，执行引擎会记录还原所需的所有内容。写入后，会重新读取网站数据，并与预览承诺的结果进行比对。如果不匹配，会报告 VerificationFailed，而不会显示为成功。
• 审计并回滚。 每项更改都会以简明语句写入日志，你可以在 wp-admin 中查看；已应用的更改也可以从那里回滚——但需要先预览。
• 所有者可控制，Agent 无法触及。 你可以在控制台中通过一个开关暂停所有写入、关闭单项操作或整个模块、设置各个已连接应用在每种集成中的权限（Off、Read、Edit 或 Full），以及撤销凭据。这些控制均无法通过 MCP 访问。

有些限制是刻意为之，而非功能缺失：不支持执行 PHP、原始 SQL 或访问文件系统；不支持永久删除内容（移除内容即移入回收站——唯一例外是 media-delete，它会进行预览并明确说明无法撤销）。插件和主题只能通过 slug 从 WordPress.org 安装，或通过媒体库中已有的 zip 安装，绝不会从 Agent 选择的地址安装；新安装的项目会保持停用状态。

→ 写入约定、审计记录和权限模型详见 docs/INTERNALS.md。

提示词示例

“列出此网站上的 Elementor 文档，然后展示主页的元素树。”

“预览将第 412 页的标题更改为‘春季活动’。不要应用更改。先向我展示差异。”

“查找所有链接到旧版定价页面的文章，并更新这些链接。应用前先预览每项更改。”

“ACF 是否已启用，且是否达到最低版本要求？然后列出产品页面上的字段组。”

免费版和专业版

免费插件包含完整的安全模型：两阶段写入、快照、验证、审计日志、回滚和所有控制台控件。这些功能始终免费，而且批量操作数量绝不会成为收费理由——免费插件支持单项写入，就也支持批量写入。

SiteHelm Pro 是通过 Freemius 销售的独立附加组件。它新增了 53 项操作，覆盖免费插件无法触及的功能：

插件是开源的，因此免费版与 Pro 版的界限有据可查，而非空口承诺。

隐私

SiteHelm 不包含 AI 模型，也不会将任何站点内容发送到任何地方。它仅会发起以下外连：向 GitHub releases 检查更新、安装附加组件时检查 Pro 许可证、请求安装 Pro 时查询 WordPress.org，以及执行你所请求的媒体导入。

参与贡献

欢迎提交错误报告、功能请求和拉取请求。CONTRIBUTING.md 介绍了工作流，以及变更必须满足的标准。

composer install
composer test    # PHPUnit
composer lint    # phpcs

每次推送时，测试套件都会在 PHP 8.1、8.2 和 8.3 上运行；CI 会强制要求行覆盖率至少达到 80%；每个操作定义都由黄金测试样例固定，因此能力、风险等级或回滚策略若有变更，都会显示在差异中。详情请参阅 docs/INTERNALS.md。

安全

请勿公开提交漏洞问题。请使用 GitHub 的私密漏洞报告。SECURITY.md 中列有备用联系方式、需要提供的信息和响应时间。

许可证

GNU 通用公共许可证第 2 版或更高版本，与 WordPress 使用相同的许可证。