Kirby CMS
CLI-first MCP server for composer-based Kirby CMS projects — inspect blueprints/templates/plugins, interact with a real Kirby runtime, and use a bundled Kirby knowledge base.
What is Kirby CMS?
Kirby CMS is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to cli-first mcp server for composer-based kirby cms projects — inspect blueprints/templates/plugins, interact with a real kirby runtime, and use a bundled kirby knowledge base.
CLI-first MCP server for composer-based Kirby CMS projects — inspect blueprints/templates/plugins, interact with a real Kirby runtime, and use a bundled Kirby knowledge base.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- CLI-first MCP server for composer-based Kirby CMS projects —
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx kirbyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Kirby CMS
Kirby MCP is a CLI-first Model Context Protocol server for Composer-based Kirby CMS projects that lets AI coding agents like Claude Code, Codex CLI, and Cursor inspect, reason about, and interact with a live Kirby runtime without guessing at file layouts. It exposes tools for reading blueprints, templates, snippets, controllers, models, plugins, routes, and page content, plus a bundled local knowledge base of Kirby concepts and tasks for offline reference. The server supports both stdio (for local development) and HTTP transport (for production use as a Kirby route), making it suitable for individual developers and team setups alike.
Prerequisites
- PHP 8.2 or higher
- Composer installed and available on PATH
- An existing Kirby CMS 5 project managed with Composer
- An MCP-compatible client: Claude Code, Codex CLI, or Cursor
Install kirby-mcp via Composer
From your Kirby project root, require kirby-mcp as a dev dependency (or a normal dependency for HTTP/production mode).
composer require bnomei/kirby-mcp --devRun the install command
Execute the bundled install script to complete setup, configure the MCP client integration, and copy Skills if applicable.
vendor/bin/kirby-mcp installStart the MCP server in stdio mode
Launch the Kirby MCP server for use with your local MCP client. It runs over stdio and does not open a port.
vendor/bin/kirby-mcpConfigure your MCP client
Add the server to your Claude Code or Cursor MCP configuration. The install command may do this automatically; verify or add manually if needed.
Verify the connection
Ask your agent to list available Kirby roots or blueprints to confirm the server is connected and can reach the Kirby runtime.
Kirby CMS Examples
Client configuration
Add this to your Claude Desktop claude_desktop_config.json or Claude Code MCP settings to connect to the Kirby MCP server in your project.
{
"mcpServers": {
"kirby": {
"command": "php",
"args": ["/path/to/your-kirby-project/vendor/bin/kirby-mcp"]
}
}
}Prompts to try
Use these prompts in Claude Code or Cursor after connecting to the Kirby MCP server.
- "Use the Kirby MCP to make a plan to build a contact form page"
- "Show me the fields available on the home page blueprint and what they do using the MCP"
- "Show me the current content of the about page"
- "List all blueprints, templates, snippets, and plugins in this Kirby project"
- "kirby search for collection filtering"
- "kirby search online for panel permissions"
- "Append ' — Updated' to the title of the home page with Kirby MCP"Troubleshooting Kirby CMS
Server fails to start because Kirby runtime cannot be bootstrapped
Ensure you run 'vendor/bin/kirby-mcp' from your Kirby project root where the composer.json and index.php reside. The server expects to find the Kirby bootstrap at the working directory.
kirby_eval tool is not available in the agent
kirby_eval is disabled by default for security reasons. To enable it, add the relevant config option to your Kirby config.php. Review the security implications before enabling eval in any environment exposed to untrusted data.
Agent edits files directly instead of using MCP tools
Prefix your request with 'Use the Kirby MCP to make a plan to...' rather than asking the agent to take direct action. This reliably triggers MCP tool use and produces a plan before any file edits.
Frequently Asked Questions about Kirby CMS
What is Kirby CMS?
Kirby CMS is a Model Context Protocol (MCP) server that cli-first mcp server for composer-based kirby cms projects — inspect blueprints/templates/plugins, interact with a real kirby runtime, and use a bundled kirby knowledge base. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Kirby CMS?
Follow the installation instructions on the Kirby CMS GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Kirby CMS?
Kirby CMS works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Kirby CMS free to use?
Yes, Kirby CMS is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Kirby CMS Alternatives — Similar Developer Tools Servers
Looking for alternatives to Kirby CMS? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Kirby CMS in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Kirby CMS?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.