Docker Techstack Rolldev Mcp Server

by dockergiant

279 downloads
Not rated
GitHub

About

MCP server for Roll Docker Stack and multi-framework development environments.

Details

Author
dockergiant
Downloads
279
Categories
Cloud Service, Developer Tools

- List, start, and stop RollDev project environments
- Control RollDev system services (database, Redis, OpenSearch)
- Execute SQL queries in project databases
- Run PHP scripts inside project containers
- Execute Magento CLI commands via roll magento
- Run Composer commands in project environments
- Initialize new Magento 2 projects with automatic configuration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Docker Techstack Rolldev Mcp Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npx (npx -y @disrex/rolldev-mcp-server) and add the configuration to your Claude for Desktop config file (claude_desktop_config.json). Alternatively, clone the repository and set up manually. The server exposes tools like rolldev_list_environments, rolldev_start_project, rolldev_db_query, rolldev_magento_cli, and others.

rolldev_list_environments

List all running RollDev environments with their directories (returns structured JSON)

rolldev_start_project

Start a RollDev project environment

rolldev_stop_project

Stop a RollDev project environment

rolldev_start_svc

Start RollDev system services

rolldev_stop_svc

Stop RollDev system services

rolldev_db_query

Run a SQL query in the RollDev database

rolldev_php_script

Run a PHP script inside the php-fpm container

rolldev_magento_cli

Run roll magento command inside the php-fpm container

rolldev_composer

Run Composer commands inside the php-fpm container

rolldev_magento2_init

Initialize a new Magento 2 project using RollDev's magento2-init command with automatic version configuration

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "docker techstack rolldev mcp server": {
            "rolldev": {
                "command": "npx",
                "args": [
                    "-y",
                    "@disrex/rolldev-mcp-server"
                ]
            }
        }
    }
}

McpServers

{
    "rolldev": {
        "command": "npx",
        "args": [
            "-y",
            "@disrex/rolldev-mcp-server"
        ]
    }
}

RollDev MCP Server

npm version
License: MIT
Node.js CI
JavaScript
RollDev
Magento
Docker
MCP

A Model Context Protocol (MCP) server for RollDev + Magento 2 development environments. This server enables Claude and other LLMs to interact with RollDev projects, manage environments, execute commands, and initialize new Magento 2 projects seamlessly.

Features

Environment Management

- Environment Control: List, start, and stop RollDev project environments - Service Management: Control RollDev system services (database, Redis, OpenSearch, etc.) - Project Initialization: Create new Magento 2 projects with automatic configuration

Development Tools

- Database Operations: Execute SQL queries directly in project databases - PHP Script Execution: Run PHP scripts within project containers - Magento CLI Access: Execute Magento commands through roll magento - Composer Integration: Run Composer commands in project environments

Prerequisites

- RollDev installed and configured
- Node.js 18+
- Active RollDev project environments (for some operations)

Installation

Option 1: Using NPM (Recommended)

{
  "mcpServers": {
    "rolldev": {
      "command": "npx",
      "args": [
        "-y",
        "@disrex/rolldev-mcp-server"
      ]
    }
  }
}

Add this configuration to your Claude for Desktop config file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

Option 2: Manual Setup

1. Clone this repository:

git clone https://github.com/dockergiant/rolldev-mcp-server.git
cd rolldev-mcp-server

2. Install dependencies:

npm install

3. Add to Claude configuration:

{
"mcpServers": {
"rolldev": {
"command": "node",
"args": ["/path/to/rolldev-mcp-server/server.js"]
}
}
}

Available Tools

rolldev_list_environments

Lists all running RollDev environments with structured information including project names, paths, URLs, Docker networks, and container counts.

rolldev_start_project

Starts a RollDev project environment. - project_path: Path to the project directory

rolldev_stop_project

Stops a RollDev project environment. - project_path: Path to the project directory

rolldev_start_svc

Starts RollDev system services. - project_path: Path to the project directory

rolldev_stop_svc

Stops RollDev system services. - project_path: Path to the project directory

rolldev_db_query

Executes SQL queries in project databases. - project_path: Path to the project directory - query: SQL query to execute - database: Database name (optional, defaults to "magento")

rolldev_php_script

Runs PHP scripts inside project containers. - project_path: Path to the project directory - script_path: Path to PHP script relative to project root - args: Additional arguments (optional)

rolldev_magento_cli

Executes Magento CLI commands. - project_path: Path to the project directory - command: Magento command (without 'bin/magento' prefix) - args: Additional arguments (optional)

rolldev_composer

Runs Composer commands in project environments. - project_path: Path to the project directory - command: Composer command (e.g., "install", "update", "require symfony/console")

rolldev_magento2_init

Initializes new Magento 2 projects with automatic configuration. - project_name: Project name (lowercase, letters, numbers, hyphens only) - magento_version: Magento version (optional, defaults to "2.4.x") - target_directory: Target directory (optional, defaults to current directory)

Examples

Here are some example interactions you can try with Claude after setting up the RollDev MCP server:

Basic Environment Management

1. "Can you list all my RollDev environments?" 2. "Start the project at /path/to/my-magento-project" 3. "Stop the services for my current project"

Database Operations

4. "Run the query 'SELECT * FROM admin_user LIMIT 5' in my project" 5. "Show me all enabled modules in the database" 6. "Check the current configuration values for my store"

Magento Development

7. "Execute 'cache:flush' Magento command in my project" 8. "Run 'setup:upgrade' on my Magento installation" 9. "List all available Magento CLI commands"

Project Initialization

10. "Initialize a new Magento 2.4.7 project called 'my-store'" 11. "Create a Magento project with the latest version in /Users/dev/projects"

Composer Operations

12. "Install dependencies with Composer in my project" 13. "Require the symfony/console package in my project"

Development

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.