Shilpi for WordPress

Shilpi MCP 服务

将 Claude、ChatGPT 或任何兼容 MCP 的 Agent 连接到使用 Shilpi 主题的 WordPress 网站，让它通过受限的功能而非服务器访问权限来构建和编辑网站。

此仓库提供公开接口：注册表清单、工具列表、身份验证指南和客户端配置示例。服务本身随 Shilpi 主题一起提供，并运行在你自己的 WordPress 安装上，因此无需注册任何服务，也没有第三方介于 Agent 和你的网站之间。

• 产品和定价：https://shilpibuilder.com/
• 文档：https://shilpibuilder.com/docs/
• 权限模型说明：https://shilpibuilder.com/abilities-not-access/

为何创建此项目

大多数 WordPress 页面构建器都会用自己的格式存储布局。Agent 接到编辑此类页面的任务时，必须学习专有的小组件树、猜测其中的不变量，并希望供应商不会更改它们。

Shilpi 将页面存储为三个普通字段：正文 HTML、实际样式表和精简的 JavaScript。编辑 Shilpi 页面时，Agent 操作的是它已经理解的标记。它需要从网站获取的不是原始访问权限，而是一套词汇：有哪些全局类、定义了哪些设计变量，以及有哪些网站规范。这正是这些工具所提供的内容。

端点

服务运行在你自己的网站上。将 example.com 替换为你的域名。

用途	URL
Streamable HTTP，OAuth	https://example.com/wp-json/mcp/shilpi-oauth
Streamable HTTP，应用程序密码	https://example.com/wp-json/shilpi/v1/mcp
OAuth 受保护资源元数据	https://example.com/wp-json/shilpi/v1/oauth/protected-resource
面向 Agent 的网站摘要	https://example.com/llms.txt

两个端点都需要有效许可证。没有许可证时，它们会返回 404，任何凭据都无法通过身份验证。在 Shilpi → Dashboard → Connect an AI agent 中关闭服务后，两个端点都会被移除，这是真正的紧急关闭开关，而非普通设置。

要求

• WordPress 6.4 或更高版本
• PHP 8.0 或更高版本
• HTTPS，OAuth 必需
• 已启用且拥有有效许可证的 Shilpi 主题

开始连接

请参阅 docs/authentication.md，了解 OAuth 流程和应用程序密码备用方案；有关可直接粘贴使用的客户端配置，请参阅 examples/。

功能

每个工具都有明确的作用范围。没有文件系统访问权限，没有 SSH，也无法访问 wp-config.php 或主题和插件文件。编写 PHP 代码片段是一项临时权限，需要网站所有者在 Shilpi → Security 中授予，也可以一键撤销。

以下列表由运行 Shilpi 1.9.4 的实际安装生成。数量会随版本更新而变化；启用 WooCommerce Kit 插件后，它也会添加自己的工具。

页面、文章和模板

工具	功能
shilpi-site-info	网站标识、版本、清单、断点、限制、模板路由
shilpi-list-pages	列出页面、文章和模板，包括 ID、别名和固定链接
shilpi-get-page	读取一份文档：正文 HTML、页面 CSS、页面 JS、页眉和页脚
shilpi-save-page	创建或更新页面、文章或模板；按别名确保幂等
shilpi-set-page-code	设置文档的页面 CSS 和 JavaScript
shilpi-delete-page	移除一份文档
shilpi-import-page	将单个静态 HTML 文件导入为 Shilpi 文档
shilpi-import-site	导入包含模板、CSS、图片和菜单的静态 HTML 文件夹

设计系统

工具	功能
shilpi-manage-variables	列出并更新设计令牌，支持为不同断点设置值
shilpi-manage-classes	列出并管理全局 CSS 类及其状态
shilpi-get-globals	读取全局 CSS 和 JS，以及默认页眉、页脚和首页
shilpi-set-globals	写入这些全局设置

结构和内容

工具	功能
shilpi-manage-menu	创建并排序导航菜单，将其分配到对应位置
shilpi-manage-taxonomy	管理分类、标签和自定义分类法
shilpi-get-seo	读取标题、描述、规范链接、robots 和社交字段
shilpi-set-seo	通过网站所使用的 SEO 插件写入这些字段
shilpi-upload-media	将图片导入媒体库；按源 URL 保证幂等
shilpi-search-icons	搜索已安装的图标库
shilpi-manage-icon-libraries	添加和移除图标库

代码和资源

工具	功能
shilpi-list-php-snippets	列出 Code Hub 代码片段及其启用状态和错误状态
shilpi-get-php-snippet	读取单个代码片段及其内容哈希
shilpi-save-php-snippet	创建或更新代码片段，并进行语法检查和哈希保护
shilpi-configure-php-snippet	启用或停用代码片段；启用前先进行测试运行
shilpi-delete-php-snippet	移除代码片段
shilpi-list-script-files	列出受管理的 JavaScript 文件
shilpi-upload-script-file	上传可信的库或打包文件
shilpi-configure-script-file	设置启用状态、加载优先级和 jQuery 依赖
shilpi-list-project-files	列出项目 JSON 和资源文件
shilpi-upload-project-file	上传生成的 JSON，并返回同源 URL
shilpi-delete-project-file	移除项目文件或脚本文件
shilpi-set-site-manifest	激活 Web 应用清单
shilpi-list-fonts	列出可自托管的字体
shilpi-upload-font	上传 WOFF2、WOFF、TTF 或 OTF 字体并注册
shilpi-delete-font	移除字体

Agent 指令

工具	功能
shilpi-get-skill	加载 Markdown 技能：shilpi-theme 或 wordpress-core

技能用于告知 Agent 网站自身的约定。你可以上传自己的 Markdown 技能来添加内部规则，Agent 会在写入前读取这些规则。

服务无法执行的操作

连接前，值得先了解这一部分。

• 无法访问文件系统，因此不能读取或写入主题或插件文件。
• 无法使用 shell，也无法通过 SSH 访问 wp-config.php。
• 无法通过 WooCommerce 工具访问客户、订单、地址或支付数据。
• PHP 写入默认关闭；它是一项可关闭的权限，而不是启用后就无需再管的设置。
• 上传 JavaScript 需要使用具有 unfiltered_html 权限的账户。

许可证

此仓库的内容（清单、文档和示例）采用 MIT 许可证发布。Shilpi 主题本身是商业软件；请参阅 https://shilpibuilder.com/pricing/。