AlphaBridge MCP for WordPress

AlphaBridge MCP — 免费插件

通过对话管理你的 WordPress 网站。 AlphaBridge MCP 将 WordPress 网站变成原生的 Model Context Protocol 服务。Claude、ChatGPT 和其他 MCP 客户端通过一个经过身份验证的 HTTPS 端点连接。它们可以撰写和编辑文章、页面、媒体、分类目录和标签，回复和审核评论，还能读取小工具、网站设置，以及使用区块或常见页面构建器构建的页面大纲。每个工具在每次调用时都会检查 WordPress 权限。

在管理员启用一个开关以允许写入之前，网站仅提供读取功能。启用后，所有工具均可使用；每个连接都会保留其访问级别（完全访问、仅内容访问或只读）。关闭开关只需点击一次。

此代码库包含免费插件的源代码，该插件已发布在 WordPress.org 插件目录中。此处代码与 WordPress.org 发布的代码完全相同。

• 插件页面： https://wordpress.org/plugins/alphabridge-mcp/
• 网站与文档： https://alphabridge-mcp.com
• 工具参考： https://alphabridge-mcp.com/docs.html
• 安全模型： https://alphabridge-mcp.com/security.html

功能

• 原生 MCP 端点 — 在 /wp-json/alphabridge/v1/mcp 上通过 HTTP POST 使用 JSON-RPC 2.0 （并行支持协议版本 2024-11-05、2025-03-26、2025-06-18 和无状态版本 2026-07-28；最新版本可以关闭）。完全在 WordPress 中使用 PHP 实现：无需 Node 中间件、外部服务或额外托管内容。

• 40 个结构化工具，涵盖内容、媒体、分类法、评论、小工具、站点设置、站点信息、SEO 读取和搜索。

• 页面构建器 — wp_get_builder_layout 将页面作为大纲读取：按页面中的顺序列出元素，并包含其可见文本、链接和图片字段；无法安全读取的元素（例如代码、表单或未知元素）会列为已锁定，并说明原因，不包含其内容。

  • 读取：WordPress 区块、Elementor、Beaver Builder、SiteOrigin Page Builder、SeedProd、GenerateBlocks、Kadence Blocks、Spectra、Stackable、Pagelayer、Otter Blocks 和 CoBlocks（均作为普通区块读取）、WPBakery Page Builder、Divi 4、Avada（Fusion Builder）、Flatsome（UX Builder）和 Enfold（Avia Layout Builder）。
  • 按照供应商文档读取：WPBakery Page Builder、Divi 4、Avada、Flatsome 和 Enfold。
  • 可识别但不读取：Brizy、Themify Builder、Zion Builder、Live Composer、Cornerstone、Thrive Architect、Bricks、Breakdance、Oxygen 6、Oxygen Classic、BeTheme（BeBuilder）、Visual Composer Website Builder、Divi 5 和 Etch。

  对于使用构建器自己的数据展示内容、而 post_content 只是副本的构建器（Elementor、Beaver Builder、SiteOrigin Page Builder 和 Enfold），在构建器处于启用状态时，wp_update_post 会拒绝修改内容，因为修改不会显示出来，并会说明应如何更改页面。

  wp_get_post 会指出文章使用的构建器（built_with），wp_list_posts 可按构建器筛选，wp_duplicate_post 会复制页面及其自定义字段和构建器数据（如果可读取布局，Elementor 元素会获得新 ID；否则会原样复制，并在答复中说明；只有拥有 unfiltered_html 权限的账户才能复制构建器数据）。

• OAuth 2.1 和 PKCE — 无需复制令牌即可从 Claude 连接；同意页面位于受登录保护的自有站点上，并提供只读、内容和完全访问三种权限，每种都用一句话说明，默认选中完全访问；站点上的写入权限开关决定连接能否写入。应用可向站点注册（RFC 7591），也可通过客户端元数据文档（CIMD）标识自身；只有当有权批准连接的已登录用户打开同意页面时，站点才会获取该文档，而且此功能可以关闭。对于没有连接按钮的客户端，支持通过请求头进行身份验证（Authorization / X-Api-Key）。

• 答案会指出可行的办法 — 当 AlphaBridge 自身的检查拒绝调用或报告失败时，答复会说明哪里没成功、原因是什么，以及应该怎么做：用于查找 ID 的工具、所需权限、开关和可接受的值。如果因关闭写入权限、访问级别不足、用户角色权限不足或工具被关闭而拒绝调用，答复会提供操作步骤和直接链接，并请求用户礼貌转告相关人员后重试；对于属于独立产品 AlphaBridge MCP Pro 的工具，会明确指出其所属产品，而不是显示为“未知工具”。WordPress 自身报告的错误会按原文传递。

• 免费就是免费 — 无需许可证密钥或注册，没有使用限制，也没有锁定功能。

安全模型

将 AI 访问权限交给站点应该让人安心，因此控制权是首要考虑：

• 默认关闭写入权限。 新站点，以及从早于 4.4.0 的版本升级后的所有站点，初始时都关闭写入权限：助手可以读取内容、媒体、分类项、评论、设置和站点结构。所有会创建、更改或删除内容的工具都会被拒绝，所有标注为仅限写入权限的读取工具（在此插件中为读取用户个人资料字段的工具）也会被拒绝，并说明原因、引导用户打开开关。Settings → AlphaBridge MCP 顶部的主开关 Write access for AI assistants 对所有连接（Claude、ChatGPT、Cursor 及其他连接）均有效；管理员确认并勾选以下内容后才能将其打开：更改会立即生效、风险由站点所有者自行承担，且已有当前备份。系统会记录账户、时间、该提示的版本和措辞。打开开关会启用所有工具；关闭只需点击一次。
• 每个连接都以一个真实的 WordPress 用户身份运行；每个工具都会执行相应的权限检查，包括对象级检查。用户无权执行的操作，AI 也无权执行。
• 限定范围的连接——只读或仅限内容的密钥，可选设置过期时间，并可一键轮换。
• 精细控制——所有工具均已启用，打开写入权限会再次启用所有工具；可关闭单个工具或整个分组，直到下次打开写入权限前，这些工具都会从 MCP 接口中消失。每个工具都会显示管理员所用语言的简短名称，并注明其读取或写入属性。 代码通过 AB_MCP_Site_Mode（get()、is_full()、allows()、runs_in_read()）读取开关状态（标识符 read 和 full 分别表示关闭和打开写入权限）；读取代码、文件、数据库、日志或凭据的工具会标记为 'dangerous' => true，在关闭写入权限时不会启用。切换写入权限时会触发操作 ab_mcp_site_mode_changed；从关闭切换为打开并启用所有工具时会触发 ab_mcp_reset_switches（扩展在此处启用自己的项目）。精细控制会将扩展的字段纳入统一表单（筛选器 ab_mcp_fine_group_html、操作 ab_mcp_fine_save）。
• 采用正向允许列表，而非阻止列表——完全无法读取任意选项和 transient；只开放一份固定的常用站点设置列表，以及通过 wp_get_widgets 获取的已注册小工具设置，但不包含下方凭据防护机制拒绝的键值。
• 分层元数据保护——受保护的键、is_protected_meta() 保护的键，以及两类符合凭据特征的键都会被拒绝：名称完全等于凭据词的键，无论单数还是复数（token、secret、password、passphrase、passcode、pwd、otp、credential）；以及名称包含固定复合模式列表中任一项的键（api_key、access_token、client_secret、license_key、oauth、_token、_secret、_password、……）。匹配采用字面匹配，因此该防护机制有意采取保守策略，而非追求穷尽：token_count、password_hint 等普通键，以及 maxTokens 等计数器都能通过；accessToken 这类驼峰式拼写也能通过。这是纵深防御措施，并非主要控制手段。此外，通用元数据访问还会检查 WordPress 自身针对每个键的元数据权限（edit_post_meta / edit_term_meta / edit_user_meta），以遵守其他插件注册的 auth_callback 规则——这才是真正发挥作用的一层。页面构建器数据若以标记或代码形式存储在页面中，即使构建器将其保存在不带 _ 的键下（例如 panels_data、dslc_code、pagelayer-data、brizy、mfn-page-items 或 tve_updated_post），也只有具备 unfiltered_html 权限的账户才能通过 wp_create_post 和 wp_update_post 的 meta 参数写入；其他账户的调用会在写入任何内容之前被拒绝。有一个只读工具会按设计读取更多内容：对于有权编辑该文章的账户，wp_get_builder_layout 会读取该文章由页面构建器保存的数据，包括受保护的键，并且仅返回其中元素的可见文本、链接和图片字段——绝不会返回原始元数据、代码、样式或属性；用于保存页面自身脚本或 CSS 的独立键则完全不会读取。 wp_duplicate_post 也会复制受保护的键，但只会复制到新草稿中，且仅限有权编辑原文章的账户：WordPress 自身的页面模板、特色图片和已移除挂载区块列表；此外，页面构建器的文章元数据包含标记，因此只有具备 unfiltered_html 权限时才会复制，并且要么一并复制各构建器的所有键，要么完全不复制。符合凭据特征的键、原文章的编辑状态、修订版本的元数据、构建器缓存以及其他插件的受保护键都不会复制。
• 审计日志记录最近 200 次工具调用，并设有每分钟 120 个请求的速率限制，以应对请求突发。 详情：https://alphabridge-mcp.com/security.html

要求

WordPress 6.5+（已测试至 7.1）· PHP 8.0+

安装

在 WordPress 管理后台的 插件 → 安装插件 中安装 AlphaBridge MCP，或从 WordPress.org 安装。

如需直接运行此代码库，请将其克隆到插件目录，并命名为 alphabridge-mcp：

git clone https://github.com/CultureClub-dev/alphabridge-mcp-free.git wp-content/plugins/alphabridge-mcp

然后启用插件，并打开 设置 → AlphaBridge MCP 创建连接。

付费扩展

单独的商业扩展 AlphaBridge MCP Pro 可让助手完成更多操作：

• 更改各种页面构建器页面上的文本、链接和图像；
• 执行其他插件提供的功能；如果执行结果显示文章已成功更新，但实际并未保存，也会明确说明；
• 编辑插件和主题文件，以及 Code Snippets 或 WPCode 的 PHP 代码片段；
• 保存已启用的 PHP 代码后，通过测试请求检查网站；如果其中一个请求以致命错误结束，则自动还原到之前的版本；
• 使用数据库、用户、菜单、WooCommerce、SEO 写入、安装/更新、迁移和多站点工具组；
• 撤销通过此扩展所做的许多更改（撤销点默认在 7 天后过期，可调整为 1 至 30 天）。

其 Agency 计划为代理机构和开发者提供 Site Deploy：通过 SFTP 将文件、主题和完整构建版本发布到网站运行所在的服务器；ZIP 部署可以原子方式执行，如果切换失败则回滚。

Pro 可免费试用 7 天，无需信用卡。两者均为完全可选项：此免费插件本身功能完整，即使不使用这些扩展也能保持全部功能。其源代码不属于此代码库。详情请访问 https://alphabridge-mcp.com。

贡献与支持

欢迎提交错误报告和安全问题——请参阅 SECURITY.md 了解报告方式。一般支持问题最好在 WordPress.org 支持论坛 中提出。

此代码库与已发布的版本保持同步；日常开发在其他地方进行，因此拉取请求可能会手动应用，而非直接合并。

许可证

GPL-2.0-or-later——请参阅 LICENSE。

由 CultureClub Kulturagentur UG (haftungsbeschränkt) 出品， 在瑞士开发。