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