kirby-mcp

Overview

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

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• kirby_blueprint_read

  Read a single blueprint by id

  Try:Show me the home page blueprintTry:Read the contact page blueprint
• kirby_blueprints_index

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

  Try:List all blueprintsTry:Show all available page blueprints
• kirby_read_page_content

  Read page content by id or uuid

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

  Update page content, requires confirmation

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

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

  Try:Render the home page as HTMLTry:Show me how the blog page looks
• kirby_search

  Search the bundled local Kirby knowledge base markdown files

  Try:Search for collection filteringTry:Look up panel information
• kirby_online

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

  Try:Search online for panel permissionsTry:Find info about custom fields
• kirby_eval

  Execute PHP in Kirby runtime for quick inspection

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

  Evaluate Kirby query language (dot-notation) strings

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

  Suggest the best next Kirby MCP tool for a task

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

  Show resolved Kirby roots via kirby roots command

  Try:Show Kirby project rootsTry:Display root paths
• kirby_init

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

  Try:Initialize Kirby MCP sessionTry:Start new project session

Comparable tools

Installation

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

Is this server only for Kirby CMS projects?

Yes, this MCP server is specifically designed for Composer-based Kirby CMS projects and requires a Kirby installation to function properly.

Can I modify page content through this MCP server?

Yes, the server provides tools like kirby_update_page_content to modify page content, but these operations require confirmation for safety.

Compare kirby-mcp with