Respira For Wordpress

Respira WordPress MCP 服务

适用于 19 种页面构建器的 MCP 工具和 WordPress 能力。WordPress 的 AI 基础设施层。
元素级编辑、完整页面创建、将 HTML 和 Figma 转换为原生构建器内容、设计方向、站点记忆、无障碍与安全扫描、逐工具治理、快照和回滚。

网站 • 文档 • 插件 • MCP 配置 • 技能 • 支持

这个仓库是什么，又不是什么

此仓库是 Respira WordPress MCP 服务的公开项目页。服务源码以 @respira/wordpress-mcp-server 的形式发布在 npm 上。该包装器代码采用 MIT 许可证，欢迎阅读、派生或集成。

该服务是 Respira WordPress 插件的客户端，并非独立产品。要执行实际操作，需要：

• 在你的网站上安装 Respira for WordPress 插件
• 绑定到许可证的有效 Respira API 密钥

该插件并非开源。 它以商业许可证发行。可在 respira.press 免费试用，无需银行卡。付费方案起价为每月 9 欧元。

简而言之：你通过 npx -y 获取的包装器是开源的。它背后的产品不是开源的，这是有意为之。如果你想要一套不依赖商业产品、可独立运行的“AI 编辑 WordPress”方案，这并不适合你。该插件由一人全职开发和维护，许可证费用正是这项工作的资金来源。

安全问题报告请参阅 SECURITY.md。

Respira 的不同之处

大多数 WordPress MCP 服务只是封装 REST API。它们可以创建文章和页面，但无法操作页面构建器内容，而网站的实际内容正是由这些内容构成的。

Respira 提供一个 WordPress 插件，让 AI Agent 能够原生访问页面构建器自身的数据结构，并提供安全保障，让向线上网站写入内容也能安心进行。

快速开始

1. 安装 WordPress 插件

从 respira.press/plugin 下载，上传到 WordPress 并启用，然后前往 Respira > API Keys 生成密钥。

2. 连接 AI 工具

最快的方法是在 respira.press/dashboard/mcp 使用生成的命令，它会自动填入你的网站和密钥。下方提供手动配置方法。

claude mcp add respira-wordpress -- npx -y @respira/wordpress-mcp-server

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server"]
    }
  }
}

[mcp_servers.respira-wordpress]
command = "npx"
args = ["-y", "@respira/wordpress-mcp-server"]

npx add-mcp "npx -y @respira/wordpress-mcp-server"

3. 添加你的网站

运行向导：

npx @respira/wordpress-mcp-server --setup

或者自行编写 ~/.respira/config.json：

{
  "sites": [
    {
      "id": "my-site",
      "name": "My WordPress Site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true
    }
  ]
}

重启 AI 工具并开始编辑。

遇到客户端工具数量限制？

部分 MCP 客户端会限制可启用的工具数量，通常上限为 100 个。Respira 提供的工具远超此数量，因此请在配置中添加 enabledTools，这样列表中只会显示指定的工具：

{
  "sites": [{ "...": "..." }],
  "preferences": {
    "enabledTools": [
      "respira_read_page",
      "respira_update_page",
      "respira_list_pages",
      "respira_find_element",
      "respira_update_element",
      "respira_build_page",
      "respira_get_site_context",
      "respira_get_builder_info"
    ]
  }
}

网站管理工具（respira_list_sites、respira_switch_site、respira_get_active_site）始终会包含在内。直接调用未列出的工具仍然有效。筛选器只控制哪些工具会显示出来。

此外，服务还会根据你的网站实际运行的内容筛选工具列表。没有安装 WooCommerce 的 Divi 网站不会显示电商工具。如果检测失败，系统会默认开放：无法确定时，将显示完整列表。

支持 19 种页面构建器

level 表示 Respira 的写入深度，而非构建器的质量。

混合构建器网站按页面处理，而非按整个网站处理。

工具涵盖的内容

完整参考文档见 docs。功能类别如下：

所有工具都使用 respira_* 名称。旧版 wordpress_* 别名已弃用，并将移除。

数字的含义

当前数量来自在线工具目录，每次发布都会根据代码统计：整个产品及每种套餐的 MCP 工具、WooCommerce 插件的工具，以及 WordPress Abilities。这些数字描述的是所有功能均已启用的站点上的目录，而不是客户端会列出的内容。

在线 tools/list 返回的工具少于目录总数，这是正确行为，并非缺少功能。服务会根据站点上下文筛选目录，因此 Bricks 工具不会出现在 Elementor 站点上，而未安装 WooCommerce 时，电商工具会保持隐藏。没有页面构建器的区块主题站点所能看到的核心工具还会更少。

Abilities 注册表不会按上下文筛选，因此在同一站点上，Abilities 数量确实会超过工具数量。两者不能直接比较。

内置技能

此软件包附带 Respira 的 Claude Code 技能，这些技能提供了让工具协同发挥作用的方案：页面构建器迁移（Divi 到 Bricks、Elementor 到 Gutenberg、WPBakery 到 Bricks 等）、Figma 到页面构建器的转换、站点审计、SEO 和 AEO 检查，以及 WooCommerce 工作流。

npx @respira/wordpress-mcp-server install-skills

在 respira.press/skills 浏览目录。

安全性

向在线生产站点写入内容是整个问题的核心。防护措施如下：

1. 每次修改前创建快照。 使用 respira_restore_snapshot 恢复，使用 respira_diff_snapshots 比较。
2. 编辑前先复制。 原始内容保持不变，Agent 在副本上操作。
3. 逐个工具进行治理。 管理员可在 wp-admin 中启用或停用单个工具。治理措施同样适用于 REST 路径、Abilities API 路径和 WebMCP。
4. 只读模式。 让 Agent 连接站点并查看内容，但不允许写入。
5. 活动日志。 记录每次调用，可在 wp-admin 中查看，也可通过 respira_list_activity 查看。

WordPress AI 生态系统

Respira 与官方 WordPress AI 技术栈协同工作，而不是绕过它。

Inhale 是免费的配套插件，可在完全不使用 Respira 账户的情况下注册少量 Abilities；如果你想先试试 Abilities 路径，可以先从它开始。

安装选项

npx

npx -y @respira/wordpress-mcp-server

无需安装，适合试用。缺点是：安装中断、外接硬盘断开或被杀毒软件隔离后，npx 缓存可能损坏，进而产生令人困惑的 ENOENT 错误。请参阅“故障排除”。

全局安装（最稳定）

npm install -g @respira/wordpress-mcp-server
respira-wordpress-mcp

完全避开 npx 缓存。更适合日常使用。

命令行选项

环境变量

export WORDPRESS_URL="https://yoursite.com"
export WORDPRESS_API_KEY="respira_your_key"

RESPIRA_CONFIG_FILE 和 RESPIRA_CONFIG_B64 是多站点配置的替代方式。

Grok Build 插件

此仓库也是 Grok Build 的 Respira 插件的源代码。该插件刻意保持精简，只包含两个文件，不包含其他内容：

• .grok-plugin/plugin.json，清单文件。
• .mcp.json，一个 MCP 服务定义：npx -y @respira/wordpress-mcp-server，与本 README 中介绍的包相同。

它没有技能、命令、Agent、钩子或安装脚本。

首次使用前。 在站点上安装 Respira for WordPress 插件，然后运行一次 npx @respira/wordpress-mcp-server --setup。这会将站点列表写入 ~/.respira/config.json，Grok Build 启动服务时会读取该文件。如果该文件中没有站点，服务启动后只提供一个工具 respira_redeem_token；该工具会从 respira.press/dashboard/mcp 获取设置代码，并为你写入站点列表。

服务调用的网络端点。

凭据。 每个站点使用一个 Respira 站点密钥，保存在你设备上的 ~/.respira/config.json 中（单站点也可使用 WORDPRESS_URL 和 WORDPRESS_API_KEY）。密钥只会通过请求标头发送给所属站点。WordPress 插件会验证该密钥；服务不会读取 SSH 密钥、.env 文件或其他令牌。

不使用插件。 Grok Build 也可以直接访问站点，每个站点使用一条命令：请参阅 respira.press/integrations/grok。

健康检查

npx @respira/wordpress-mcp-server --doctor

检查 Node 版本、配置文件、站点连接、插件版本、API 兼容性和可用更新，并针对每项检查报告通过或失败，同时提供可执行的处理建议。添加 --json 可用于 CI 流水线。

故障排查

{ "command": "C:\\Program Files\\nodejs\\npx.cmd", "args": ["-y", "@respira/wordpress-mcp-server"] }

{
  "sites": [
    {
      "id": "my-site",
      "url": "https://yoursite.com",
      "apiKey": "respira_your-api-key",
      "default": true,
      "forceRestRoute": true
    }
  ]
}

# 1. Switch to a global install, most stable
npm install -g @respira/wordpress-mcp-server
# then use "command": "respira-wordpress-mcp" with no npx wrapper

# 2. Or clear the npx cache and let it rebuild
npx clear-npx-cache
npx -y @respira/wordpress-mcp-server

# 3. Or clear the whole npm cache
npm cache clean --force

安全

API 密钥由 WordPress 插件在服务端验证。MCP 服务只传递凭据，不会存储或验证凭据。

请将漏洞报告发送至 [email protected]。完整政策请参阅 SECURITY.md。

链接

• 网站
• 文档
• 下载插件
• MCP 设置
• 技能目录
• 能力
• WooCommerce 扩展
• 无障碍扫描器扩展
• 支持

Respira 收录目录

许可证

MIT © Respira

根据代码统计的完整工具目录：respira.press/tools。WordPress 的 AI 基础设施层。
respira.press