kirby-mcp

概述

Kirby MCP 是一个专为 Kirby CMS 设计的 MCP 服务器，采用 CLI-first 方式工作。它提供了丰富的工具来检查项目结构（蓝图、模板、插件等），与 Kirby 运行时交互，并包含一个本地知识库。该服务器支持内容读取、更新，IDE 助手生成，以及 Kirby CLI 命令执行等功能。其设计理念是减少对外部资源的依赖，提供快速、可靠的开发环境支持。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• kirby_blueprint_read

  Read a single blueprint by id

  试试:Show me the home page blueprint试试:Read the contact page blueprint
• kirby_blueprints_index

  Index blueprints, includes plugin-registered ones when runtime is installed

  试试:List all blueprints试试:Show all available page blueprints
• kirby_read_page_content

  Read page content by id or uuid

  试试:Show me the content of the home page试试:Read about page content
• kirby_update_page_content

  Update page content, requires confirmation

  试试:Change the title of the contact page试试:Append 'with AI' to the about page title
• kirby_render_page

  Render a page by id or uuid and return HTML plus errors

  试试:Render the home page as HTML试试:Show me how the blog page looks
• kirby_search

  Search the bundled local Kirby knowledge base markdown files

  试试:Search for collection filtering试试:Look up panel information
• kirby_online

  Search official Kirby docs (online fallback) and fetch markdown pages

  试试:Search online for panel permissions试试:Find info about custom fields
• kirby_eval

  Execute PHP in Kirby runtime for quick inspection

  试试:Run $site->index()->count() to see page count试试:Check page status with PHP code
• kirby_query_dot

  Evaluate Kirby query language (dot-notation) strings

  试试:Query site.find('notes').unlisted.count试试:Count page siblings for notes model
• kirby_tool_suggest

  Suggest the best next Kirby MCP tool for a task

  试试:What tool should I use to list plugins?试试:Help me find the right tool for updating page content
• kirby_roots

  Show resolved Kirby roots via kirby roots command

  试试:Show Kirby project roots试试:Display root paths
• kirby_init

  Session guidance plus project-specific audit, call once per session

  试试:Initialize Kirby MCP session试试:Start new project session

可对比工具

安装

composer require bnomei/kirby-mcp --dev
vendor/bin/kirby-mcp install
vendor/bin/kirby-mcp

{
  "mcpServers": {
    "kirby": {
      "command": "php",
      "args": ["vendor/bin/kirby-mcp"],
      "env": {
        "KIRBY_MCP_PROJECT_ROOT": "/path/to/your/kirby/project"
      }
    }
  }
}

FAQ

这个服务器只适用于 Kirby CMS 项目吗？

是的，这个 MCP 服务器专门为基于 Composer 的 Kirby CMS 项目设计，需要安装 Kirby 才能正常运行。

我可以通过这个 MCP 服务器修改页面内容吗？

是的，服务器提供了诸如 kirby_update_page_content 之类的工具来修改页面内容，但这些操作需要确认以确保安全。

kirby-mcp 对比