softspring/cms-mcp-plugin

MCP server tools plugin for Armonic CMS.

6.0.x-dev 2026-06-23 07:12 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 site metadata, published content, internal links, menus, 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_get_site_context
• sfs_cms_search_published_content
• sfs_cms_get_published_content
• sfs_cms_find_internal_links
• sfs_cms_get_menu_context
• sfs_cms_media_list_image_types
• sfs_cms_media_search_images
• sfs_cms_media_get_image_context

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

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.