kirby-mcp

Kirby MCP is a Model Context Protocol server designed for Composer-based Kirby CMS projects, enabling developers and AI agents to inspect project structure, blueprints, templates, snippets, controllers, and plugins through an interactive CLI-first interface. It provides real-time interaction with a Kirby runtime environment, allowing agents to read page content, render templates, execute queries, and run CLI commands with built-in security controls. The server ships with a local knowledge base covering Kirby concepts, common tasks, and field update guides, plus fallback access to official Kirby documentation and plugin directory search. This integration allows Claude Code, Cursor, and other AI agents to make informed plans for content management, form building, configuration updates, and debugging tasks within Kirby projects, reducing reliance on external documentation lookups.

1. **Install Kirby MCP**: Ensure Kirby MCP is installed and running in your environment. You can verify this by running `kirby-mcp --version` in your terminal. 2. **Connect to Your Project**: Use the `connect` command in Kirby MCP to link to your Kirby CMS project. For example: `kirby-mcp connect /var/www/my-site`. 3. **Inspect Blueprints**: Run the inspection command (e.g., `kirby-mcp inspect blueprint article.yml`). Replace `article.yml` with the name of your blueprint file. 4. **Review Output**: Analyze the output for issues like missing fields, inconsistencies, or deprecated options. Use the suggestions to update your blueprints and templates. 5. **Iterate and Test**: After making changes, re-run the inspection to ensure all issues are resolved. Test the updated blueprints in your Kirby admin panel to confirm they work as expected.