Garchi CMS MCP

面向 AI Agent 的 Garchi CMS

借助 AI Agent、官方入门套件和生产级 MCP 集成，使用 Garchi CMS 构建和管理结构化网站与应用。

---

使用你偏好的框架和 AI 编码 Agent 进行构建，Garchi 则提供结构化内容后端。应用只需编写一次；之后，业务团队可以持续管理内容，无需常规修改应用代码。

Garchi CMS 是什么

Garchi CMS 是由 LumenHarbor Digital Solutions Limited 提供的托管式无头 CMS。内容按以下方式组织：

• 空间 — 一个工作区，拥有其下的所有内容。
• 页面 — 按顺序排列的分区列表，每个分区都是一个分区模板的实例。模板定义了 props，并将其映射到代码库中组件的 props。
• 数据项 — 可归类的内容（博客文章、产品、活动），带有分类和键值对形式的元数据。
• 资源 — 页面分区中使用的上传文件。

你的应用通过 REST API 或 Node/PHP SDK 获取这些内容并进行渲染。它不会取代你的框架、数据库或托管服务。

此仓库提供的内容

一个可安装集成，包含三个部分。

MCP — 托管的 Garchi MCP 服务，https://garchi.co.uk/mcp-oauth。Agent 通过它读取和写入实时 CMS：列出空间、创建和编辑页面与分区，以及管理数据项、分类、元数据和资源。

技能 — 指导 Agent 正确使用 Garchi 的说明：

技能	职责
garchi-build-site	编排：了解目标、检查项目、选择入门套件或集成、连接 MCP、建立内容模型，并确认无需修改代码即可继续编辑内容。
garchi-render-content	应用代码：服务端客户端、页面和分区渲染器、嵌套分区、数据项、元数据、资源、预览模式。
garchi-manage-content	通过 MCP 执行内容操作：页面、分区、模板、数据项、分类、资源，包括如何安全处理破坏性操作。

入门套件 — Next.js、Nuxt 和 Laravel 的官方项目脚手架，引用自（而非复制自） skills/garchi-build-site/references/starter-kits.md。

此仓库打包为 Agent Plugin （plugin.json + skills/ + mcp.json），并为使用自有清单格式的客户端提供轻量适配器。所有技能集中存放在一处：更新技能后，所有受支持的 Agent 都会获得更改。

支持的 Agent 环境

Cursor

Cursor 原生加载 Agent Plugin。在该插件通过市场审核期间，可在本地安装：

git clone https://github.com/lumenharbor/garchi-cms-skills.git ~/.cursor/plugins/local/garchi-cms

然后在侧边栏中打开自定义，找到 Garchi CMS，并在提示时对 garchi MCP 服务进行身份验证。

Claude Code

将此仓库添加为插件市场，然后安装：

/plugin marketplace add lumenharbor/garchi-cms-skills

/plugin install garchi-cms@garchi-cms

在提示时使用 /mcp 授权 garchi MCP 服务。

Codex 和 ChatGPT 桌面应用

将此仓库添加为插件市场来源：

codex plugin marketplace add lumenharbor/garchi-cms-skills

然后从 ChatGPT 桌面应用的插件目录安装 Garchi CMS 并重启应用。

如果捆绑的 MCP 服务无法连接，请将其直接添加到 Codex 并登录：

codex mcp login garchi

如果仍然不行，请在 ~/.codex/config.toml 中手动添加服务：

[mcp_servers.garchi]
url = "https://garchi.co.uk/mcp-oauth"

ChatGPT

Garchi CMS 已在 ChatGPT 中注册为 MCP 连接器： chatgpt.com/plugins/plugin_asdk_app_698da77dd2f48191ba19e15b0b188796。 在此启用它，即可在 ChatGPT 中使用 Garchi 工具。该插件的 .app.json 会将 Codex 和 ChatGPT 桌面应用指向同一个已注册的连接器，因此本地安装会复用它，而不会重复注册服务。

任何兼容 Agent Plugins 的客户端

实现了 Agent Plugins v1 规范 的客户端（包括 VS Code 等） 会直接读取根目录中的 plugin.json、skills/ 目录和 mcp.json。 将客户端指向此代码库即可。

不使用插件宿主的技能

要将技能安装到 skills CLI 支持的任何 Agent 中：

npx [email protected] add lumenharbor/garchi-cms-skills

请单独配置 MCP 服务 — 各客户端的说明（包括不支持 OAuth 的客户端使用的 bearer-token 端点）请参阅 garchi.co.uk/mcp-docs。

示例提示词

安装后，无需提及 MCP 服务、技能或 SDK，即可使用以下提示词：

• “使用 Garchi CMS 构建一个 SaaS 营销网站。”
• “将 Garchi 用作此现有 Next.js 项目的 CMS。”
• “将此项目连接到我的 Garchi 空间。”
• “在 Garchi 中创建 About 和 Pricing 页面。”
• “在此前端中渲染我的 Garchi 页面。”
• “为此网站添加一个由 Garchi 数据项支持的博客。”
• “在不更改应用程序代码的情况下，修改 Garchi 中的定价文案。”
• “使用官方 Garchi 入门套件启动此项目。”

入门套件

框架	代码库	SDK
Next.js	garchi-next-starter-kit	@garchicms/garchi-node-sdk
Nuxt	garchi-nuxt-starter-kit	@garchicms/garchi-node-sdk
Laravel	garchi-laravel-starter-kit	garchicms/garchi-sdk-php

初始化任意一个：

npx @lumenharbor/[email protected] -k next

-k 接受 next、nuxt 或 laravel。

其他框架 — SvelteKit、Astro、Django、Rails、React Native — 则通过 Node SDK、PHP SDK 或 REST API 集成。虽然这些框架没有脚手架，但 Garchi 在其背后的工作方式相同。

安全性

• 身份验证在远程进行，并基于 OAuth。 捆绑的 MCP 服务为 https://garchi.co.uk/mcp-oauth。它提供采用 PKCE（S256）和动态客户端注册的 OAuth 2.1 受保护资源元数据（RFC 9728），因此受支持的客户端会自行执行授权流程并存储令牌。
• 此代码库不会存储凭据。 任何清单、技能或参考文件中都没有 API 密钥、令牌或密钥，安装插件也不需要这些信息。mcp.json 和 .mcp.json 条目只包含 URL。
• 访问权限由你的 Garchi 权限决定。 MCP 服务以已登录用户的身份运行。该插件不会授予超出此账户现有权限范围的访问权。
• 破坏性操作需要确认。 两个工具被标记为具有破坏性 — delete-section-tool 和 update-prop-template-tool — 而 garchi-manage-content 要求在运行任一工具前，明确确认每个项目；此外，客户端自身也会提示批准工具调用。
• 应用程序凭据保留在服务器端。 应用用于读取内容的 GARCHI_API_KEY 与 MCP 无关，不会暴露给浏览器，并且应存放在你自己的环境配置中 — 而不是此代码库中。

文档

• Garchi CMS 文档
• REST API · OpenAPI 规范
• MCP 客户端设置

Agent 可能会出错。如果实际行为与技能描述不符，请查阅文档。

许可证

MIT — 请参阅 LICENSE。