包简介

CMS-domain MCP tools for Magebit_Mcp (read + write over CMS pages and blocks)

README 文档

README

This is a sub-module for the Magento2 MCP module

CMS-domain MCP tools for Magebit_Mcp. Reads and writes against CMS pages and blocks.

Each tool is a thin wrapper over a Magento service contract (PageRepositoryInterface, BlockRepositoryInterface, GetPageByIdentifierInterface, GetBlockByIdentifierInterface) and composes its read response from field resolvers that 3rd-party modules can extend.

Install

composer require magebitcom/magento2-mcp-cms-tools
bin/magento module:enable Magebit_McpCmsTools
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Ships with Magebit_Mcp as its only Magebit dependency. If you only want the base MCP transport (no CMS tools), install Magebit_Mcp alone; this module is designed to be optional.

Tool catalog

Read tools

Tool	What it does
`cms.page.list`	Paginated CMS-page search; filter by identifier (exact / glob / array), title substring, is_active, store_id, website_id (expanded to store-view ids), creation_time range, update_time range.
`cms.page.get`	Single CMS page by numeric id or identifier (+ optional `store_id` for identifier lookup).
`cms.block.list`	Paginated CMS-block search with the same filter vocabulary as pages.
`cms.block.get`	Single CMS block by numeric id or identifier.

Write tools

All writes require the global magebit_mcp/general/allow_writes flag and the token's own allow_writes flag to be 1. Every write sets requires_confirmation so MCP clients (Claude Desktop, etc.) prompt before firing.

Tool	Confirm?	Delegates to	Underlying ACL
`cms.page.create`	yes	`PageRepositoryInterface::save()`	`Magento_Cms::save`
`cms.page.update`	yes	`PageRepositoryInterface::save()` (PATCH)	`Magento_Cms::save`
`cms.page.delete`	yes	`PageRepositoryInterface::delete()`	`Magento_Cms::page_delete`
`cms.block.create`	yes	`BlockRepositoryInterface::save()`	`Magento_Cms::block`
`cms.block.update`	yes	`BlockRepositoryInterface::save()` (PATCH)	`Magento_Cms::block`
`cms.block.delete`	yes	`BlockRepositoryInterface::delete()`	`Magento_Cms::block`

Every write tool also implements Magebit\Mcp\Api\UnderlyingAclAwareInterface so the handler blocks calls from admins who wouldn't be allowed to perform the same action in the admin UI.

Identifier lookups and store scope

cms.page.get, cms.page.update, cms.page.delete (and the block siblings) accept either id (numeric primary key) or identifier (the admin URL key). Identifier lookups require a store scope:

Omit store_id → defaults to 0 ("All Store Views"), which is the scope CMS pages and blocks created from the admin UI default to. This is what most identifier-only lookups want.
Pass store_id: <N> → look the entity up under store view N.

Pages / blocks assigned to a specific store view are invisible from other stores by design.

Extending

See docs/EXTENDING.md for:

adding a new field to any tool response via PageFieldResolverInterface / BlockFieldResolverInterface;
adding a new filter to cms.page.list / cms.block.list via PageFilterTranslatorInterface / BlockFilterTranslatorInterface;
the ACL layering rules for custom write tools.

License

Released under the MIT License.

Have questions or need help? Contact us at info@magebit.com

magebitcom/magento2-mcp-cms-tools 适用场景与选型建议

magebitcom/magento2-mcp-cms-tools 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 327 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 05 月 06 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 magebitcom/magento2-mcp-cms-tools 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 magebitcom/magento2-mcp-cms-tools 我们能提供哪些服务？

定制开发 / 二次开发

基于 magebitcom/magento2-mcp-cms-tools 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

magebitcom/magento2-mcp-cms-tools

包简介