返回 MCP 目录
public公开dns本地运行

magento2-dev-mcp

Magento 2开发MCP服务器,为AI代理提供模块管理、系统诊断、缓存配置和数据库工具等开发功能

article

README

🚀 Magento 2开发MCP服务器

这是一个专为Magento 2开发设计的模型上下文协议(MCP)服务器,可与Claude、Cursor、Continue.dev和Augment Code等AI代理集成,助力开发者更高效地进行Magento 2开发工作。

🚀 快速开始

  1. 添加到AI代理的MCP配置中
{
  "mcpServers": {
    "magento2-dev": {
      "command": "npx",
      "args": ["-y", "@elgentos/magento2-dev-mcp"]
    }
  }
}
  1. 重启AI代理 以加载MCP服务器。
  2. 通过AI代理开始使用Magento 2开发工具

有关特定平台的设置说明,请参阅 AI平台配置示例

✨ 主要特性

依赖注入与模块工具

get-di-preferences - 获取Magento 2依赖注入偏好列表

参数

  • scope(可选):获取DI偏好的作用域
    • 选项:globaladminhtmlfrontendcrontabwebapi_restwebapi_soapgraphqldocadmin
    • 默认值:global

可用作用域

  • global - 全局作用域(默认)
  • adminhtml - 管理区域
  • frontend - 前端/店面区域
  • crontab - 定时任务执行上下文
  • webapi_rest - REST API上下文
  • webapi_soap - SOAP API上下文
  • graphql - GraphQL API上下文
  • doc - 文档上下文
  • admin - 管理上下文(adminhtml的替代)
dev-module-list - 列出所有Magento 2模块及其状态

参数

  • format(可选):输出格式(tablejsoncsv) - 默认值:table
  • enabled(可选):仅显示已启用的模块
  • disabled(可选):仅显示已禁用的模块
dev-module-observer-list - 列出所有Magento 2模块观察者

参数

  • format(可选):输出格式(tablejsoncsv) - 默认值:table
  • event(可选):按特定事件名称过滤
dev-theme-list - 列出所有可用的Magento 2主题

参数

  • format(可选):输出格式(tablejsoncsv) - 默认值:table
dev-module-create - 创建并注册一个新的Magento 2模块

参数

  • vendorNamespace(必需):命名空间(公司前缀)
  • moduleName(必需):模块名称
  • minimal(可选):仅创建模块文件
  • addBlocks(可选):添加块
  • addHelpers(可选):添加助手
  • addModels(可选):添加模型
  • addSetup(可选):添加SQL设置
  • addAll(可选):添加块、助手和模型
  • enable(可选):创建后启用模块
  • modman(可选):在带有modman文件的文件夹中创建所有文件
  • addReadme(可选):为生成的模块添加一个readme.md文件
  • addComposer(可选):为生成的模块添加一个composer.json文件
  • addStrictTypes(可选):为生成的PHP文件添加严格类型声明
  • authorName(可选):readme.mdcomposer.json的作者
  • authorEmail(可选):readme.mdcomposer.json的作者电子邮件
  • description(可选):readme.mdcomposer.json的描述

使用示例

{
  "name": "dev-module-create",
  "arguments": {
    "vendorNamespace": "MyCompany",
    "moduleName": "CustomModule",
    "addAll": true,
    "enable": true,
    "addReadme": true,
    "addComposer": true,
    "authorName": "John Doe",
    "authorEmail": "john@example.com",
    "description": "A custom Magento 2 module"
  }
}

系统诊断

sys-info - 获取Magento 2系统信息

参数

  • format(可选):输出格式(tablejsoncsv) - 默认值:table
sys-check - 检查Magento 2系统要求和配置

参数:无

缓存管理

缓存管理工具 - 完整的缓存管理套件

可用工具

  • cache-clean - 清除特定或所有缓存
  • cache-flush - 刷新特定或所有缓存
  • cache-enable - 启用特定缓存类型
  • cache-disable - 禁用特定缓存类型
  • cache-status - 检查缓存状态
  • cache-view - 检查缓存条目

有关详细信息,请参阅 缓存类型参考

配置管理

config-show - 查看Magento 2系统配置值

参数

  • path(可选):要显示的配置路径
  • scope(可选):配置作用域(默认、网站、商店)
  • scopeId(可选):作用域ID(网站ID或商店ID)
config-set - 设置Magento 2系统配置值

参数

  • path(必需):要设置的配置路径
  • value(必需):要设置的值
  • scope(可选):配置作用域
  • scopeId(可选):作用域ID
  • encrypt(可选):加密该值
config-store-get / config-store-set - 特定商店的配置管理工具

用于在商店级别获取和设置配置值的特定商店配置管理。

数据库工具

db-query - 直接在Magento 2数据库上执行SQL查询

参数

  • query(必需):要执行的SQL查询
  • format(可选):输出格式(tablejsoncsv) - 默认值:table

设置与部署

setup-upgrade - 运行Magento 2设置升级以更新数据库架构和数据

参数

  • keepGenerated(可选):升级期间保留生成的文件
setup-di-compile - 编译Magento 2依赖注入配置

参数:无

setup-db-status - 检查数据库状态以确定是否需要运行`setup:upgrade`

参数:无

setup-static-content-deploy - 部署Magento 2静态内容和资产

参数

  • languages(可选):要部署的语言
  • themes(可选):要部署的主题
  • jobs(可选):并行作业数量
  • force(可选):强制部署

商店管理

sys-store-list - 列出所有Magento 2商店、网站和商店视图

参数

  • format(可选):输出格式(tablejsoncsv) - 默认值:table
sys-store-config-base-url-list - 列出所有Magento 2商店的基础URL

参数

  • format(可选):输出格式(tablejsoncsv) - 默认值:table
sys-url-list - 获取所有Magento 2 URL

参数

  • format(可选):输出格式(tablejsoncsv) - 默认值:table
  • storeId(可选):过滤URL的商店ID
sys-website-list - 列出所有Magento 2网站

参数

  • format(可选):输出格式(tablejsoncsv) - 默认值:table

定时任务管理

sys-cron-list - 列出所有Magento 2定时任务及其配置

参数

  • format(可选):输出格式(tablejsoncsv) - 默认值:table
sys-cron-run - 运行Magento 2定时任务

参数

  • job(可选):要运行的特定定时任务
  • group(可选):要运行的定时任务组

📦 安装指南

使用npx

npx -y @elgentos/magento2-dev-mcp

📄 许可证

本项目采用MIT许可证,详情请参阅 LICENSE 文件。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端