Warden Magento MCP Server

A comprehensive Model Context Protocol (MCP) server that provides seamless integration between AI assistants and Warden + Magento 2 development environments. This server enables AI assistants to interact directly with your Warden-managed Magento projects, automating common development tasks and providing intelligent assistance for complex workflows.

Features

This MCP server transforms your AI assistant into a powerful development companion for Warden + Magento 2 projects by providing:

• 🚀 Project Initialization: Create new Warden projects with customizable Magento 2 environments
• 🔧 Environment Management: Start/stop projects and services with intelligent state management
• 🗄️ Database Operations: Execute SQL queries directly in containerized databases
• 🐘 PHP Development Tools: Run PHP scripts in properly configured containerized environments
• 🛠️ Magento CLI Integration: Execute Magento commands seamlessly within containers
• 🧪 Unit Testing Support: Run PHPUnit tests with automatic configuration detection
• 📦 Composer Integration: Manage dependencies within containers with full command support
• 📊 Environment Monitoring: List and monitor running Warden environments

Installation

1. Clone or download this repository
2. Install dependencies:

npm install

3. Configure your MCP client (see Configuration section below)

Configuration

MCP Client Configuration

Add the following configuration to your MCP client settings:

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

Important: Replace /absolute/path/to/warden-mcp-server/server.js with the actual absolute path to the server.js file on your system.

For Claude Desktop

Add to your claude_desktop_config.json:

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

For Zed Editor

Add to your Zed settings:

{
  "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"]
    }
  }
}

Usage

Once configured, your AI assistant can automatically use these tools to help with Warden + Magento development tasks. Simply describe what you want to accomplish, and the AI will use the appropriate tools.

Available Tools

Environment Management

warden_list_environments

Lists all running Warden environments with their directories and status information.

Parameters: None

Use Cases:

• Check which environments are currently running
• Get project paths for other operations
• Monitor environment status

warden_start_project

Starts a Warden project environment, bringing up all configured containers.

Parameters:

• project_path (required): Path to the project directory

Use Cases:

• Start development environment
• Resume work on a project
• Bring up services after system restart

warden_stop_project

Stops a Warden project environment, shutting down all project containers.

Parameters:

• project_path (required): Path to the project directory

Use Cases:

• Clean shutdown of development environment
• Free up system resources
• Prepare for system maintenance

warden_start_svc

Starts Warden system services (shared infrastructure like DNS, proxy, etc.).

Parameters:

• project_path (required): Path to the project directory

Use Cases:

• Initialize Warden infrastructure
• Start shared services after system reboot
• Prepare environment for project startup

warden_stop_svc

Stops Warden system services.

Parameters:

• `project

... View full README on GitHub