kirby-mcp

为 Kirby CMS 项目提供 MCP 服务器,支持项目洞察与全局知识库查询。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:kirby-mcp。
它的用途是:为 Kirby CMS 项目提供 MCP 服务器,支持项目洞察与全局知识库查询。
完整的 Skill 内容见:https://321skill.com/skills/kirby-mcp/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘使用 Kirby MCP 来制定一个计划,为我的 Kirby 网站添加一个博客文章归档页面。’ 它会首先调用工具查看你项目现有的蓝图和模板结构,然后基于 Kirby 的知识库给出创建页面蓝图、模板和可能需要的控制器的具体步骤建议。

介绍

Kirby MCP 是一个专为 Composer 驱动的 Kirby CMS 项目设计的 CLI 优先 MCP 服务器。它主要解决了开发者在 IDE 或 AI 智能体环境中,难以直接洞察 Kirby 项目结构(如蓝图、模板、插件)并与真实运行时环境交互的问题。

使用上,开发者可以在 Kirby 项目根目录通过 Composer 快速安装并启动一个本地 stdio MCP 服务器。该服务器提供了丰富的工具,允许智能体读取项目蓝图、模板、代码片段,渲染页面,甚至执行查询和内容更新操作。此外,它还支持以全局参考模式运行,作为一个独立的、始终在线的 Kirby 知识库和文档搜索引擎。

这个 Skill 非常适合使用 Kirby CMS 进行网站开发的全栈开发者、后端开发者以及需要为 Kirby 项目编写代码或文档的内容创作者。它能够显著提升在 Kirby 生态中进行开发、调试和内容规划的效率。

需要注意的是,由于该工具允许与项目运行时交互并执行操作,在与不受信任的文档或提示一起使用时,存在提示注入的安全风险。建议在可控的开发环境中使用,并理解其工具的能力范围。

核心特点

核心区别在于它深度集成 Kirby CMS 运行时,不仅能作为静态文档查询工具,更能直接读取项目蓝图、渲染页面、执行代码,实现了对 Kirby 项目的“活”洞察与操作;同时提供独立的全局参考模式,将项目开发工具与常驻知识库分离,架构清晰。

注意事项

不适合非 Kirby CMS 项目,且在全局参考模式下无法进行任何项目相关的文件操作或运行时交互。

常见问题

如何在 Claude Desktop 或 Cursor 中使用 Kirby MCP?

安装 Skill 后,参考仓库的 Client setup 部分,将生成的服务器配置添加到对应客户端的配置文件中即可连接。

全局模式和项目本地模式有什么区别?

全局模式仅提供 Kirby 知识库、文档和插件目录搜索,不依赖具体项目;项目本地模式则能深入读取和操作当前 Kirby 项目的文件与运行时。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/kirby-mcp/raw/index.md 读取 kirby-mcp 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。