GMC Builder MCP Lite

GMC Builder 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

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

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

指南和介绍

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

先决条件

Python 3.10 或更高版本。目标站点必须安装 GMC Builder：WordPress 编写 API（2.0.0+）并配有应用程序密码，或 Joomla 远程 API（2.0.1+）并配有共享的 X-Gmc-Builder-Key。本仓库不分发 GMC Builder。请通过 GMC 获取 CMS 产品；Lite 不包含布局导出端点。

从 GitHub 安装

git clone https://github.com/gmcfuerte/gmcbuilder-mcp-lite.git
cd gmcbuilder-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. 将 GMCBUILDER_MCP_LITE_SITES 设置为该本地 JSON 文件的绝对路径。
4. 使用 mcp.example.json 添加服务：将占位符替换为 Python 可执行文件和配置文件的绝对路径。确保 MCP 客户端将凭据变量传递给其子进程。
5. 先运行 gmcbuilder_lite_list_sites，然后运行 gmcbuilder_lite_ping_site。

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

工具

• gmcbuilder_lite_list_sites：仅返回别名和平台。
• gmcbuilder_lite_ping_site：执行一次经过身份验证的 GET 请求；仅返回经过清理的状态。
• gmcbuilder_lite_list_element_types：最多列出十种构建器元素名称；不提供架构或套件导出。
• gmcbuilder_lite_summarize_layout：将 layout.example.json 中的文本作为 layout_json 传入。 返回计数和类型；不包含设置或内容。

服务在本地通过 stdio 运行。不包含远程 HTTP 服务、上传、任意 URL、SSH、许可证开关或 Pro 模块。在线工具使用固定的 GET 允许列表、经过验证的 TLS、不跟随重定向、每个已配置基 URL 同时最多发起一个请求、两秒间隔，以及 1 MiB 的响应上限。仅当主机名与环回地址完全匹配时才接受 HTTP。收到 HTTP 403/415 后，直到重启前都不会再向该基 URL 发起请求。

发布状态

Lite 初始版本：已检查源代码和软件包内容，并已编译 Python。尚未执行站点集成和运行时测试。请勿将此初始版本视为生产集成认证。

联系方式

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