STARWARCLOUD STARWAR.AI
返回市场
守卫者-MCP-服务器

守卫者-MCP-服务器

作者：run-as-root5 星标更新：2025-07-04
安装使用来源：spider==github.com

项目介绍

Warden Magento MCP 服务器

一个全面的模型上下文协议（MCP）服务器，提供AI助手与Warden + Magento 2 开发环境之间的无缝集成。此服务器使AI助手能够直接与您的Warden管理的Magento项目交互，自动化常见的开发任务，并为复杂的流程提供智能辅助。

功能

此MCP服务器通过提供以下功能，将您的AI助手转变为Warden + Magento 2 项目的强大开发伴侣：

  • 🚀 项目初始化：创建具有可定制Magento 2环境的新Warden项目
  • 🔧 环境管理：启动/停止项目和服务，具有智能状态管理
  • 🗄️ 数据库操作：在容器化的数据库中直接执行SQL查询
  • 🐘 PHP 开发工具：在正确配置的容器化环境中运行PHP脚本
  • 🛠️ Magento CLI 集成：在容器内无缝执行Magento命令
  • 🧪 单元测试支持：自动检测配置后运行PHPUnit测试
  • 📦 Composer 集成：在容器内管理依赖项，支持完整命令
  • 📊 环境监控：列出并监控正在运行的Warden环境

安装

  1. 克隆或下载此仓库
  2. 安装依赖项：
npm install
  1. 配置您的MCP客户端（参见下面的配置部分）

配置

MCP 客户端配置

在您的MCP客户端设置中添加以下配置：

{
  "mcpServers": {
    "warden-magento": {
      "command": "node",
      "args": ["/absolute/path/to/warden-mcp-server/server.js"],
      "env": {}
    }
  }
}

重要：将 /absolute/path/to/warden-mcp-server/server.js 替换为您系统上 server.js 文件的实际绝对路径。

对于 Claude Desktop

在您的 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "warden-magento": {
      "command": "node",
      "args": ["/Users/your-username/path/to/warden-mcp-server/server.js"]
    }
  }
}

对于 Zed 编辑器

在您的Zed设置中添加：

{
  "assistant": {
    "version": "2",
    "provider": {
      "name": "anthropic",
      "model": "claude-3-5-sonnet-20241022"
    }
  },
  "context_servers": {
    "warden-magento": {
      "command": "node",
      "args": ["/Users/your-username/path/to/warden-mcp-server/server.js"]
    }
  }
}

使用

配置完成后，您的AI助手可以自动使用这些工具来帮助Warden + Magento开发任务。只需描述您想要完成的任务，AI将使用适当的工具。

可用工具

环境管理

warden_list_environments

列出所有正在运行的Warden环境及其目录和状态信息。

参数：无

使用场景：

  • 检查当前正在运行的环境
  • 获取其他操作的项目路径
  • 监控环境状态

warden_start_project

启动Warden项目环境，启动所有已配置的容器。

参数：

  • project_path（必需）：项目目录的路径

使用场景：

  • 启动开发环境
  • 恢复项目工作
  • 系统重启后启动服务

warden_stop_project

停止Warden项目环境，关闭所有项目容器。

参数：

  • project_path（必需）：项目目录的路径

使用场景：

  • 清洁关闭开发环境
  • 释放系统资源
  • 准备系统维护

warden_start_svc

启动Warden系统服务（共享基础设施如DNS、代理等）。

参数：

  • project_path（必需）：项目目录的路径

使用场景：

  • 初始化Warden基础设施
  • 系统重启后启动共享服务
  • 为项目启动准备环境

warden_stop_svc

停止Warden系统服务。

参数：

  • project_path（必需）：项目目录的路径

使用场景：

  • 清洁关闭Warden基础设施
  • 排查服务冲突
  • 系统维护

项目初始化

warden_init_project

初始化一个新的Warden项目，带有完全配置的Magento 2环境。

参数：

  • project_path（必需）：项目初始化的位置
  • project_name（必需）：Warden环境的名称
  • environment_type（可选）：环境类型（默认：magento2）
  • php_version（可选）：PHP版本（默认：8.3）
  • mysql_distribution（可选）：MySQL发行版（默认：mariadb）
  • mysql_version（可选）：MySQL版本（默认：10.6）
  • node_version（可选）：Node.js版本（默认：20）
  • composer_version（可选）：Composer版本（默认：2）
  • opensearch_version（可选）：OpenSearch版本（默认：2.12）
  • redis_version（可选）：Redis版本（默认：7.2）
  • enable_redis（可选）：启用Redis（默认：true）
  • enable_opensearch（可选）：启用OpenSearch（默认：true）
  • enable_varnish（可选）：启用Varnish（默认：true）
  • enable_rabbitmq（可选）：启用RabbitMQ（默认：true）
  • enable_xdebug（可选）：启用Xdebug（默认：true）

使用场景：

  • 设置新的Magento 2开发环境
  • 创建具有特定PHP/MySQL版本的项目
  • 根据特定需求配置环境
  • 使用自定义服务堆栈初始化项目

数据库操作

warden_db_query

在Warden数据库容器中直接执行SQL查询。

参数：

  • project_path（必需）：项目目录的路径
  • query（必需）：要执行的SQL查询
  • database（可选）：数据库名称（默认：magento）

使用场景：

  • 执行调试数据库查询
  • 检索数据进行分析
  • 执行数据库维护任务
  • 检查数据库模式或数据

PHP 开发

warden_php_script

在php-fpm容器中运行PHP脚本，具有正确的环境设置。

参数：

  • project_path（必需）：项目目录的路径
  • script_path（必需）：相对于项目根目录的PHP脚本路径
  • args（可选）：传递给脚本的附加参数

使用场景：

  • 执行自定义PHP脚本
  • 运行数据迁移脚本
  • 测试PHP功能
  • 执行维护脚本

Magento CLI

warden_magento_cli

在php-fpm容器中执行Magento CLI命令。

参数：

  • project_path（必需）：项目目录的路径
  • command（必需）：Magento CLI命令（不带 bin/magento 前缀）
  • args（可选）：命令的附加参数

使用场景：

  • 运行缓存操作（cache:clean, cache:flush）
  • 执行设置命令（setup:upgrade, setup:di:compile）
  • 管理配置（config:set, config:show）
  • 运行索引操作（indexer:reindex）
  • 模块管理（module:enable, module:disable）

测试

warden_run_unit_tests

在php-fpm容器中运行PHPUnit测试，自动检测配置。

参数：

  • project_path（必需）：项目目录的路径
  • config_file（可选）：PHPUnit配置文件（自动检测 phpunit.xml.dist 或 phpunit.xml）
  • test_path（可选）：特定测试文件或目录的路径
  • extra_args（可选）：附加的PHPUnit参数

使用场景：

  • 运行模块的单元测试
  • 执行特定的测试套件
  • 使用自定义配置运行测试
  • 通过自动化测试验证代码更改

依赖管理

warden_composer

在php-fpm容器中执行Composer命令。

参数：

  • project_path（必需）：项目目录的路径
  • command（必需）：要执行的Composer命令

常用命令：

  • install - 安装依赖项
  • update - 更新依赖项
  • require package/name - 添加新依赖项
  • remove package/name - 移除依赖项
  • require-commerce - 安装Adobe Commerce（如果适用）
  • dump-autoload - 重新生成自动加载器

使用场景：

  • 安装项目依赖项
  • 向项目添加新包
  • 更新现有依赖项
  • 管理自动加载
  • 安装Adobe Commerce组件

前提条件

  • Warden：必须安装并配置在您的系统上
  • Docker：Warden运行所需
  • Node.js：版本18.0.0或更高
  • MCP 客户端：兼容的MCP客户端（Claude Desktop, Zed等）

故障排除

对于此MCP服务器的具体问题，请检查：

许可证

MIT许可证 - 详情请参阅LICENSE文件

贡献

欢迎贡献！请随时提交问题和拉取请求。

相关项目