RollDev MCP服务器
](https://badge.fury.io/js/@disrex%2Frolldev-mcp-server)  ](https://github.com/dockergiant/rolldev-mcp-server/actions/workflows/nodejs-ci.yml)    ](https://docker.com) 
一种模型上下文协议（MCP）服务器 RollDev +Magento 2开发环境。此服务器使Claude和其他LLM能够无缝地与RollDev项目交互、管理环境、执行命令和初始化新的Magento 2项目。
特性
环境管理
- 环境控制：列出、启动和停止RollDev项目环境
- 服务管理：控制RollDev系统服务（数据库、Redis、OpenSearch等）
- 项目初始化：使用自动配置创建新的Magento 2项目
开发工具
- 数据库操作：直接在项目数据库中执行SQL查询
- PHP脚本执行：在项目容器中运行PHP脚本
- Magento CLI访问：通过执行Magento命令
roll magento - 作曲家集成：在项目环境中运行Composer命令
可靠性特征
- 命令超时：所有命令都有适当的超时，以防止挂起（5-15分钟，具体取决于操作）
- 输出文件重定向：将命令输出保存到日志文件以供以后调查的选项
先决条件
- RollDev 已安装并配置
- Node.js 18+
- 活动RollDev项目环境（用于某些操作）
安装
选项1：使用NPM（推荐）
{
"mcpServers": {
"rolldev": {
"command": "npx",
"args": [
"-y",
"@disrex/rolldev-mcp-server"
]
}
}
}将此配置添加到您的Claude for Desktop配置文件中：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
选项2：手动设置
- 克隆此存储库：
git clone https://github.com/dockergiant/rolldev-mcp-server.git
cd rolldev-mcp-server- 安装依赖项：
npm install- 添加到Claude配置：
{
"mcpServers": {
"rolldev": {
"command": "node",
"args": ["/path/to/rolldev-mcp-server/server.js"]
}
}
}可用工具
rolldev_list_环境
列出所有正在运行的RollDev环境，其中包含结构化信息，包括项目名称、路径、URL、Docker网络和容器计数。
rolldev_start_项目
启动RollDev项目环境。
- 项目路径：项目目录的路径
rolldev_stop_项目
停止RollDev项目环境。
- 项目路径：项目目录的路径
rolldev_start_svc
启动RollDev系统服务。
- 项目路径：项目目录的路径
rolldev_stop_svc
停止RollDev系统服务。
- 项目路径：项目目录的路径
rolldev_dbquery
在项目数据库中执行SQL查询。
- 项目路径：项目目录的路径
- 怎么翻译：要执行的SQL查询
- 数据库：数据库名称（可选，默认为“magento”）
rolldev_php_script
在项目容器内运行PHP脚本。
- 项目路径：项目目录的路径
- 脚本路径：相对于项目根的PHP脚本路径
- 参数：附加参数（可选）
rolldev_magento_cli
执行Magento CLI命令（超时5分钟）。
- 项目路径：项目目录的路径
- 命令：Magento命令（不带'bin/Magento'前缀）
- 参数：附加参数（可选）
- save_output_to_file：将完整输出保存到日志文件（可选，默认值：false）
rolldev_composer
在项目环境中运行Composer命令（超时10分钟）。
- 项目路径：项目目录的路径
- 命令：Composer命令（例如，“安装”、“更新”、“需要symfony/console”）
- save_output_to_file：将完整输出保存到日志文件（可选，默认值：false）
Rolldev代理2初始化
使用自动配置初始化新的Magento 2项目（超时15分钟）。
- 项目名称：项目名称（小写、字母、数字、连字符）
- magento版本：Magento版本（可选，默认为“2.4.x”）
- target_directory：目标目录（可选，默认为当前目录）
例子
以下是一些在设置RollDev MCP服务器后可以尝试与Claude进行交互的示例：
基础环境管理
- “你能列出我的所有RollDev环境吗？”
- “在/path/to/my magento项目中启动项目”
- “停止我当前项目的服务”
数据库操作
- “在我的项目中运行查询‘SELECT\*FROM admin_user LIMIT 5’”
- “显示数据库中所有已启用的模块”
- “检查我的商店的当前配置值”
Magento开发
- “在我的项目中执行'cache:flush'Magento命令”
- “在我的Magento安装上运行‘setup:upgrade’”
- “列出所有可用的Magento CLI命令”
项目初始化
- “初始化一个名为“我的商店”的新Magento 2.4.7项目”
- “在/Users/dev/projects中创建最新版本的Magento项目”
作曲家操作
- “在我的项目中安装Composer的依赖项”
- “在我的项目中需要symfony/console包”
输出文件重定向
- “运行安装程序：升级并将输出保存到文件中以供调查”
- “执行composer安装，并将输出保存到日志文件中”
发展
# Start in development mode with debugging
npm run dev
# Run tests
npm test测试
您可以使用MCP检查器测试服务器：
npx @modelcontextprotocol/inspector node server.js贡献
- 从以下位置分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
支持
如果您遇到任何问题或有疑问：
- 检查
- 请参阅MCP文件 模型上下文协议.io
- 以详细的复制步骤打开新一期
______________________________________________________________________