softspring/cms-mcp-plugin

MCP server tools plugin for Armonic CMS.

6.0.x-dev 2026-06-25 10:59 UTC

Requires

• php: >=8.4
• softspring/cms-bundle: ^6.0@dev
• softspring/media-bundle: ^6.0@dev
• symfony/dependency-injection: ^6.4 || ^7.4 || ^8.0
• symfony/framework-bundle: ^6.4 || ^7.4 || ^8.0
• symfony/http-foundation: ^6.4 || ^7.4 || ^8.0
• symfony/http-kernel: ^6.4 || ^7.4 || ^8.0
• symfony/mcp-bundle: ^0.10
• symfony/routing: ^6.4 || ^7.4 || ^8.0

Requires (Dev)

• ergebnis/composer-normalize: ^2.50
• friendsofphp/php-cs-fixer: ^3.94
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.5
• rector/rector: ^2.3
• symfony/yaml: ^6.4 || ^7.4 || ^8.0

AGPL-3.0-or-later

README

Experimental package: this plugin is in active development and its configuration, tool contracts, permissions, and extension points may change before a stable release.

softspring/cms-mcp-plugin exposes controlled Armonic CMS capabilities through MCP server tools.

The current package provides read-only CMS context tools for project configuration, site metadata, published content, internal links, menus, optional analytics, media image type requirements, existing media image search, and detailed media image context.

Installation

composer require softspring/cms-mcp-plugin:^6.0@dev

The plugin requires softspring/cms-bundle, softspring/media-bundle, and symfony/mcp-bundle.

Register the bundle if Symfony Flex does not do it automatically:

// config/bundles.php
return [
    Softspring\CmsMcpPlugin\SfsCmsMcpPlugin::class => ['all' => true],
];

Usage

This plugin registers read-only MCP tools under the sfs_cms_ prefix.

Available tools include:

• sfs_cms_sites_list
• sfs_cms_sites_get_context
• sfs_cms_configuration_get_context
• sfs_cms_analytics_get_site_metrics
• sfs_cms_analytics_query_pages
• sfs_cms_contents_search_published
• sfs_cms_contents_get_published
• sfs_cms_routes_find_internal_links
• sfs_cms_menus_get_context
• sfs_cms_media_images_list_types
• sfs_cms_media_images_search
• sfs_cms_media_images_get_context

Tools should remain explicit, permission-aware, and focused on safe CMS operations that can be used by local or remote agents.

Analytics tools are provider-agnostic. The MCP plugin consumes the statistics API exposed by softspring/cms-analytics-plugin when that plugin is installed and configured. Provider-specific integrations such as Plausible, GA4 or project-specific services belong in cms-analytics-plugin, not in this MCP package.

Shared Serialization

The MCP tools delegate CMS serialization to shared services under Softspring\CmsBundle\Serialization.

These shared serializers are intentionally not tied to MCP attributes, tool names, or MCP sessions. Future CMS API packages, CLI commands and assistant integrations should reuse this layer instead of depending on Softspring\CmsMcpPlugin\Mcp\* tool classes directly.

Features

See FEATURES.md for the functional scope of this package.

Contributing

See CONTRIBUTING.md.

Report issues and send Pull Requests

Security

See SECURITY.md.

License

This package is free and released under the AGPL-3.0 license.