Ddev MCP Server

MCP server for DDEV development environments with multi-database support

Local serverstdioTypeScript

What is the Ddev MCP Server?

Ddev MCP lets Claude, Cursor and other MCP clients work with Ddev MCP directly. MCP server for DDEV development environments with multi-database support.

What Ddev MCP does

This project provides a Model Context Protocol (MCP) server that enables Large Language Models (LLMs) and AI assistants to interact with DDEV local development environments.

Requirements

  • Node.js 20+ - DDEV installed and accessible via PATH - DDEV projects configured

Practical notes

  • Maintained by AkibaAT, written in TypeScript.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
ddev_db_backupCreate database snapshots
ddev_db_describe_tableGet table structure/schema (PostgreSQL \d or MySQL DESCRIBE)
ddev_db_list_backupsList available database backups
ddev_db_list_databasesList all databases (PostgreSQL \l or MySQL SHOW DATABASES)
ddev_db_list_tablesList all tables in the database (auto-detects database type)
ddev_db_queryExecute SQL queries with detailed error reporting (supports PostgreSQL, MySQL, MariaDB)
ddev_db_restoreRestore from database snapshots
ddev_list_projectsList all DDEV projects with status
ddev_project_statusGet current status and configuration of a DDEV project
ddev_start_projectStart a DDEV project
ddev_stop_projectStop a DDEV project
ddev_restart_projectRestart a DDEV project
ddev_exec_commandExecute commands in DDEV web service
ddev_exec_serviceExecute commands in specific DDEV services (web, db, redis, etc.)
ddev_sshSSH access and connection information
ddev_logsGet service logs
ddev_composer_commandRun Composer commands
ddev_xdebugControl Xdebug (on/off/toggle/status)
ddev_shareShare project via ngrok tunnel
ddev_mailpitAccess Mailpit for email testing
ddev_export_dbExport database dumps
ddev_import_dbImport database dumps

How to install the Ddev MCP Server

{
  "mcpServers": {
    "ddev": {
      "command": "ddev-mcp"
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js 20+ - DDEV installed and accessible via PATH - DDEV projects configured

Example prompts to try

  • “Use Ddev MCP to ddev composer command.”
  • “Use Ddev MCP to ddev xdebug.”
  • “Use Ddev MCP to ddev share.”

Frequently asked questions

MCP server for DDEV development environments with multi-database support Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.