GMC YOOtheme MCP Lite

YOOtheme MCP Lite

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

Lite 和 Pro

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

YOOtheme MCP Base 的费用为每年 49 欧元，适用于三个网站（12 个月，需手动续订）。请参阅当前套餐。

Lite 可依据有限商业许可免费使用。 查看源代码不代表获得再分发或转售权。

在 MCP 客户端中升级到 Pro

打开资源 升级到 Pro（gmc://lite/pro-features），查看功能对比和产品当前套餐。编辑、发布、完整导入／导出、批量编辑和恢复功能均标注为 Lite 中不可用。这些只是供参考的预览；其中不包含任何 Pro 代码或可执行的 Pro 工具。免费工具无需升级即可继续使用。

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

指南和介绍

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

前提条件

Python 3.10 或更高版本。WordPress REST API 搭配应用程序密码，或 Joomla Web Services 搭配令牌。YOOtheme 仍需单独购买许可。通用页面列表不能证明已安装 YOOtheme；布局计数功能会对你提供的 JSON 进行操作。

从 GitHub 安装

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

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

工具

• yootheme_lite_list_sites：仅列出别名和平台。
• yootheme_lite_ping_site：执行一次经过身份验证的 GET 请求，仅返回已清理的状态信息。
• yootheme_lite_list_pages：最多列出十个页面／文章的标题、ID 和状态；不导出内容。
• yootheme_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 版修复了 Joomla Web Services 的内容协商问题：Joomla 请求使用 Accept: application/vnd.api+json，而 WordPress 仍使用 application/json。 四项 HTTP 回归测试覆盖了两个平台、端点允许列表以及 HTTP 403／415 故障停止机制。2026 年 10 月 26 日，在全新安装的 Python 3.13 环境中使用 MCP SDK 1.30.0，通过了 stdio 启动、全部四个工具以及对临时 WordPress 7.1.3 和 Joomla 6.1.4 网站的只读调用测试；这些网站使用 YOOtheme Pro 5.0.53。还检查了软件包安装以及从 0.1.2 升级的情况。 这些是在限定范围的 Windows 实验环境中取得的结果，不代表生产环境、图形化托管环境或跨平台认证。YOOtheme 需另行获取许可。

联系方式

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