Elementor MCP Server

关键词

ElementorWordPressAI agentsOpenverseREST API

使用说明

  • 项目简介
    • 本仓库实现了一套基于 MCP 的服务器端组件，用于把 Elementor 的数据、工具、模板等作为 MCP 规范的工具集合对外暴露给 AI 客户端（如 Claude、Cursor 等），通过 WordPress 生态实现安全、可扩展的上下文服务。
  • 主要功能点
    • 资源与数据访问：提供对 Elementor 页面、结构、控件、模板等数据的读取能力。
    • 工具注册与执行：按 MCP 规范注册大量 Elementor 相关操作工具（创建/更新页面、容器/控件操作、图片与媒体工具、模板/全局设置等）。
    • Prompt 渲染与提示：提供示例 prompts 与模板，支持与 AI 客户端的结合使用。
    • JSON-RPC 接口：服务器通过 MCP 的 JSON-RPC 协议与客户端通信，接收请求并返回标准化响应。
    • 传输协议支持：内置 HTTP REST 传输（通过 WP REST API），并可通过本地 stdio、Node.js 代理等方式进行传输。
    • 会话与能力声明：提供会话管理、能力声明、以及可扩展的能力/工具注册机制，兼容多种 MCP 客户端。
  • 安装步骤
    • 前提条件
      • 运行 WordPress 环境，WordPress 6.x 及以上版本
      • 安装并启用 Elementor 插件
      • 安装并启用 WordPress MCP Adapter 插件
      • 根据需要安装 WordPress Abilities API
    • 安装与启用
      • 将本仓库的插件代码部署到 WordPress 插件目录，并在 WordPress 后台启用“MCP Tools for Elementor”插件
    • 连接与测试
      • MCP 服务器端 endpoint：https://your-site.com/wp-json/mcp/elementor-mcp-server
      • 客户端可通过以下任一方式连接服务器（具体见下方配置说明）并使用 initialize/init/方法调用工具
  • 服务器配置（MCP 客户端配置 MCP 服务器的启动命令和参数）
    • 说明：MCP 客户端要与服务器建立连接，需提供服务器标识、传输类型及连接参数等信息，常见的配置形式为 JSON。下列描述基于仓库实现的默认端点和可选代理模式，确保客户端能正确建立连接。
    • 直接 HTTP 连接（最常用，需提供认证信息）
      • 说明：通过 HTTP 传输直接与 WordPress MCP 服务器对接，需要在请求头中提供 HTTP 基本认证信息（username:app_password 的 Base64 编码）。
      • 配置示意（文本描述，不用代码块展示）：
        • server_name: "elementor-mcp"
        • type: "http"
        • url: "https://your-site.com/wp-json/mcp/elementor-mcp-server"
        • headers: { "Authorization": "Basic BASE64_ENCODED_CREDENTIALS" }
    • 本地 stdio + Node.js 代理（适合无网页代理环境或需额外会话管理时使用）
      • 说明：使用 bunded 的 MCP 代理将标准输入输出作为传输桥梁，代理命令通常以 Node.js 运行指定脚本。
      • 配置示例（文本描述）:
        • server_name: "elementor-mcp"
        • type: "stdio"
        • command: "node"
        • args: ["path/to/wp-content/plugins/elementor-mcp/bin/mcp-proxy.mjs"]
        • env: 例如 WP_URL、WP_USERNAME、WP_APP_PASSWORD 等环境变量，代理会自动处理会话
    • 其他代理/代理配置（Claude Desktop/Claude Code 等）
      • 仓库文档提供了 Claude Code、Claude Desktop、Cursor、Windsurf、Antigravity、Codex、npx mcp-remote 等多种集成方式，均可通过上述两种传输方式之一进行适配。配置时请按照具体代理的说明在客户端配置文件中填入对应的 serverUrl、路径、头信息等。
  • 基本使用方法
    • 初始化与调用
      • 客户端通过初始化 initialize 请求，获取服务器信息、工具能力等信息后即可调用相应的 MCP 工具。
    • 常见测试
      • 使用 curl 直接测试 initialize 调用，确认服务器返回 serverInfo 等字段，表示 MCP 服务器正常工作。
    • 客户端集成要点
      • 不同工具属于不同的命名空间，客户端在请求时应使用 elementor-mcp/tool-name 的命名惯例（MCP Adapter 会映射传输名称）。
      • 如遇协议版本兼容性问题，可通过 Node.js 代理自动处理会话与版本差异。
  • 其他
    • 服务器端提供的 Web UI（WordPress 后台）用于管理工具开关、连接信息、Prompts、Changelog 等，便于运维与调试。
    • 代码实现覆盖大量 MCP 能力群组，包括查询/发现、页面管理、布局与结构、小组件、模板与全局设置、复合能力以及各类 Pro/WooCommerce/自定义工具，具备较为完整的 MCP 服务端能力。

注：以上配置与使用说明基于本仓库提供的实现和 README 的内容整理，具体连接参数请结合实际部署环境和所使用的 MCP 客户端（Claude、Cursor、 Windsurf 等）的版本要求进行配置。

服务器信息

访问项目