Elementor MCP Lite

Elementor MCP Lite

GMC Pro 产品的免费有限版配套工具。这是一个独立的 0.1.3 客户端，拥有全新的历史记录，并且仅提供四个只读 MCP 工具。本仓库中不包含 Pro 实现。

Lite 和 Pro

功能	Lite	Pro 产品
已配置的网站别名	是	是
已验证身份的连接探测	是	是
每次调用最多 10 个文档	是	扩展工具
本地提供的 JSON：节点计数/类型	是，输入最多 64 KiB	详细检查
创建/编辑/发布布局或文档	否	付费功能
完整导出/导入、批量编辑、备份	否	付费功能
私有 Pro 实现或 CMS 配套工具源代码	不包含	单独分发

请参阅 Pro 功能和当前年度方案。如有配套工具需求或产品问题，请联系 [email protected]。

Lite 可依据有限商业许可免费使用。 代码可见不代表拥有再分发或转售权。

在 MCP 客户端中升级到 Pro

打开资源 升级到 Pro（gmc://lite/pro-features），即可查看功能对比和产品当前方案。编辑、发布、 完整导入/导出、批量编辑和恢复功能均标记为 Lite 中不可用。这些是信息性预览；不会捆绑任何 Pro 代码或可执行的 Pro 工具。免费工具无需升级即可继续使用。

MCP 客户端会自行决定如何显示资源，因此这不保证会弹出窗口或显示图形设置面板。如果客户端没有提供资源浏览器，请让助手读取该资源。

指南和介绍

• Lite 实用指南（英文）：前置条件、设置方法和首次只读会话。
• 面向客户的介绍（意大利语 PDF）：简要介绍三个 Lite 客户端和单独提供的 Pro 版本。
• Pro 功能和年度方案。

前置条件

Python 3.10 或更高版本。安装了 Elementor 和 GMC Elementor MCP 配套工具（0.5.0+）的 WordPress，以及 WordPress 应用程序密码。配套工具需通过 [email protected] 单独向 GMC 获取；其实现不包含在本仓库中。使用相应的 Elementor Pro 功能需要 Pro。Lite 的 MCP ping 检查的是配套工具，而非主题编辑能力。

从 GitHub 安装

git clone https://github.com/gmcfuerte/elementor-mcp-lite.git
cd elementor-mcp-lite
python -m venv .venv

Windows：

.venv\Scripts\python.exe -m pip install .

macOS/Linux：

.venv/bin/python -m pip install .

此 Lite 版本通过本 GitHub 仓库分发；尚未发布到 PyPI。请勿用单独提供的完整 Pro 软件包替代 Lite。

配置

1. 将 sites.example.json 复制为本地的 sites.json，并且只保留你拥有或获准访问的网站。该文件已被 Git 忽略。
2. 设置由 username_env、 password_env 和适用的 Joomla 令牌/密钥字段指定的凭据环境变量。切勿将凭据值写入已提交的 JSON 文件或 MCP 聊天中。
3. 将 ELEMENTOR_MCP_LITE_SITES 设置为该本地 JSON 文件的绝对路径。
4. 使用 mcp.example.json 添加服务：将占位符替换为 Python 可执行文件和配置文件的绝对路径。确保 MCP 客户端将凭据变量传递给其子进程。
5. 先运行 elementor_lite_list_sites，然后运行 elementor_lite_ping_site。

rest_mode: "query" 支持不使用美观 REST URL 的 WordPress；否则请使用 pretty。支持在基础 URL 中使用子目录安装。

工具

• elementor_lite_list_sites：仅列出别名和平台。
• elementor_lite_ping_site：执行一次经过身份验证的 GET 请求，仅返回经过清理的状态。
• elementor_lite_list_documents：最多列出十个 Elementor 文档的标题、ID 和状态；不导出文档。
• elementor_lite_summarize_layout：将 layout.example.json 中的文本作为 layout_json 传入。返回计数和类型；不返回设置或内容。

服务在本地使用 stdio 运行。不包含远程 HTTP 服务、上传、任意 URL、SSH、许可证切换或 Pro 模块。在线工具使用固定的 GET 允许列表、经过验证的 TLS、不跟随重定向；每个已配置的基本 URL 同时最多发起一个请求，间隔两秒，响应大小限制为 1 MiB。仅接受指向精确回环主机的 HTTP。HTTP 403/415 会导致该基本 URL 在重启前不再接受后续请求。

发布状态

版本 0.1.3 于 2026 年 10 月 26 日通过验证，测试环境使用一次性 WordPress 7.1.3、Elementor Core 4.3.5 和 GMC companion 0.5.4。真实 MCP SDK stdio 会话发现了全部四个只读工具，并测试了站点列表、经过身份验证的 ping、有界文档列表和本地布局摘要。Upgrade to Pro 资源以真实 Markdown 换行符呈现，并且对 Pro 修改工具的请求遭到拒绝。回归测试首先复现了先前的字面量 \\n 输出，并在修复后通过。

此版本仅读取 companion 的经典文档列表；不会使用 Elementor 独立的原生 MCP/Atomic 功能。实验室中无法获取 Elementor Pro 4.3.2，因此未测试其运行时功能。浏览器编辑器、截图和生产集成检查不在本次测试范围内。

联系方式

GMC · [email protected]。 独立的 GMC 软件；产品名称归各自所有者所有。