bnomei/kirby-mcp
View on GitHub ↗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.
59 ★3 forksPHPUpdated 1mo ago
What you need to know
A CLI-first MCP server for Composer-based Kirby CMS projects that lets an IDE or agent inspect blueprints, templates, plugins, and docs and interact with a real Kirby runtime, with an optional global reference mode.
Install
composer require bnomei/kirby-mcp --dev vendor/bin/kirby-mcp install Global reference mode: composer global require bnomei/kirby-mcp
Usage
- •Run vendor/bin/kirby-mcp from the project root and connect your client
- •Ask for plans to build pages, inspect blueprints, read and update content
- •Search the bundled knowledge base or fall back to online Kirby docs
- •Enable optional HTTP transport with shared-token, remote-token, or OAuth auth
Key features
- ✓37 tools, 15 resources, and 216 KB articles
- ✓Project inventory: blueprints, templates, snippets, collections, controllers, models, plugins, routes, roots
- ✓Runtime interaction: render pages, run CLI commands, eval with confirmation
- ✓Bundled local knowledge base with online docs and plugin directory fallback
- ✓15 bundled skills for common Kirby tasks
- ✓mcp_dump() debugging with secret redaction
- ✓Optional Streamable HTTP transport with scoped auth modes
Best for
Kirby CMS developers who want AI agents to safely inspect and modify their projects.
Caveats
- ⚠Supports only composer-based Kirby projects (Kirby 5, PHP 8.2+)
- ⚠Write-capable tools require explicit confirmation
- ⚠HTTP transport is disabled by default and requires Bearer auth
Clients: Cursor · Claude Code · Codex CLI · Claude Desktop
Reviewed 2026-08-11
Topics
agent-toolsagentic-workflowclaude-codeclicodex-clicommandsdeveloper-toolsgoogle-geminikirbykirby-cmsknowledge-basemcp-servermodel-context-protocolphp8promptsresourcestools
- Stars
- 59★
- Forks
- 3
- Language
- PHP
- License
- MIT
- Created
- 2025-12-17
- Last push
- 2026-07-15