Drupal MCP Server

Overview

The Drupal MCP Server is a TypeScript-based companion server that works with the Drupal MCP module. It enables AI assistants to interact with Drupal content management systems through the Model Context Protocol (MCP) using the STDIO transport.

Installation Options

The Drupal MCP Server can be installed through multiple distribution channels:

Docker Container (Recommended)

The easiest way to use the server is with Docker:

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/omedia/mcp-server-drupal",
        "--drupal-url=YOUR_DRUPAL_BASE_URL"
      ],
      "env": {}
    }
  }
}

Replace YOUR_DRUPAL_BASE_URL with the URL of your Drupal installation.

Compiled Binary

You can download pre-compiled binaries from the GitHub releases page.

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "PATH_TO_BINARY/mcp-server-drupal",
      "args": [
        "--drupal-url=YOUR_DRUPAL_BASE_URL"
      ],
      "env": {}
    }
  }
}

JSR Package

The server is also available as a JSR package:

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "deno",
      "args": [
        "run",
        "-A",
        "jsr:@omedia/mcp-server-drupal",
        "--drupal-url=YOUR_DRUPAL_BASE_URL"
      ],
      "env": {}
    }
  }
}

Authentication

The server supports authentication via environment variables. You can use either an auth token or basic authentication with username and password:

Token Authentication

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/omedia/mcp-server-drupal",
        "--drupal-url=YOUR_DRUPAL_BASE_URL"
      ],
      "env": {
        "DRUPAL_AUTH_TOKEN": "YOUR_AUTH_TOKEN"
      }
    }
  }
}

Basic Authentication

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/omedia/mcp-server-drupal",
        "--drupal-url=YOUR_DRUPAL_BASE_URL"
      ],
      "env": {
        "DRUPAL_AUTH_USER": "YOUR_USERNAME",
        "DRUPAL_AUTH_PASSWORD": "YOUR_PASSWORD"
      }
    }
  }
}

Note: Make sure to enable authentication in the Drupal MCP module settings page. If both token and username/password are provided, the token will take precedence.

Capabilities

The Drupal MCP Server exposes the following capabilities:

• Resources: Access to templates and content from your Drupal site
• Tools: Execute operations on your Drupal site

The specific instruments available are defined by the Drupal API during the initialization phase.

Additional Resources

For more detailed documentation, visit drupalmcp.io.