drush-mcp

# drush-mcp

MCP server for Drupal via Drush. Lets AI agents (Claude Code, Gemini CLI, etc.) interact with any Drupal 10+/11+ site - locally, over SSH, or via Docker - by executing Drush commands.

Two packages:
- **`@bloomidea/drush-mcp`** (npm) - TypeScript MCP server
- **`bloomidea/drush-mcp-bridge`** (Composer) - PHP Drush bridge for structured entity operations

## Requirements

- Node.js 18+
- PHP 8.1+
- Drush 12+ or 13+
- Drupal 10+ or 11+

## Quick Start

Install the MCP server:

```bash
npm install -g @bloomidea/drush-mcp
```

Install the Drush bridge on your Drupal site:

```bash
composer require bloomidea/drush-mcp-bridge
```

Add the [agent skill](skills/drupal/SKILL.md) so your agent knows how to work with Drupal entities, fields, and groups:

```bash
npx skills add Bloomidea/drush-mcp
```

> *"create a task in the Atrium group"* / *"list all published articles"* / *"check Drupal status"* / *"add a comment to node 123"*
>
> Works with [Claude Code, Gemini, Codex, Gemini, Windsurf, and 37+ agents](https://add-skill.org/).

Register in Claude Code (local):

```bash
Claude MCP add drupal -- drush-mcp --local --command "drush"
```

Or with SSH:

```bash
Claude MCP add drupal -- drush-mcp --ssh --host example.com --user deploy --root /var/www/html
```

## Configuration

Three methods: CLI flags, YAML config file, or environment variables.

### CLI Flags

```bash
# Local
drush-mcp --local --command "ddev drush"

# SSH
drush-mcp --ssh --host example.com --user deploy --root /var/www/html

# Docker (static container name)
drush-mcp --docker --host example.com --user deploy --container mycontainer

# Docker (dynamic container lookup via filter)
drush-mcp --docker --host example.com --user deploy --container-filter "label=coolify.serviceName=myapp"
```

### Config File

Create `drush-mcp.yml` in your project root or home directory, or pass `--config path`:

```yaml
sites:
  production:
    transport: ssh
    host: example.com
    user: deploy
    root: /var/www/h