Dokku MCP

Installation

Verify Installation

dokku-mcp --version

Build from Source

If you prefer to build from source:

1. Prerequisites: - Go (version 1.25 or later)

2. Clone and build:

   git clone https://github.com/dokku-mcp/dokku-mcp.git
   cd dokku-mcp
   make build
   

Development Setup

1. Prerequisites: - Go (version 1.25 or later) - Docker and Docker Compose - Make

1. Clone the repository:

   git clone https://github.com/dokku-mcp/dokku-mcp.git
   cd dokku-mcp
   

1. Install development tools:

This command installs all the necessary Go tools for development, linting, and testing.

   make install-tools
   

1. Set up the development environment:

This command sets up Git hooks to ensure code quality before commits.

   make setup-dev
   

1. Build and run from source:

   # This command builds the binary and starts the server.
   make start
   

Configuration

The server can be configured in two ways: using a config.yaml file or via environment variables.

Configuration File

Create a configuration file at one of the following locations:

• System-wide: /etc/dokku-mcp/config.yaml
• User-specific: ~/.dokku-mcp/config.yaml
• Local: config.yaml in the same directory as the binary.

Here is a minimal config.yaml example:

ssh:
  host: "your-dokku-host.com"
  user: "dokku"
  # key_path: "/path/to/your/ssh/private/key" # Optional, uses ssh-agent if empty

log_level: "info"

For a full list of available options, please refer to the config.yaml.example file.

Environment Variables

All configuration settings can be overridden with environment variables prefixed with DOKKU_MCP_. For example:

export DOKKU_MCP_SSH_HOST="your-dokku-host.com"
export DOKKU_MCP_SSH_USER="dokku"
export DOKKU_MCP_LOG_LEVEL="debug"

CORS Configuration

For SSE transport, CORS is handled by default with Access-Control-Allow-Origin: *. For remote deployments, you can enable custom CORS middleware:

transport:
  type: sse
  cors:
    enabled: true
    allowed_origins:
      - "https://app.example.com"
      - "*.example.com"

See docs/CORS.md for detailed configuration options and security best practices.

Dokku integrations

• Implemented: apps:list, apps:info, apps:create, apps:destroy, apps:exists, apps:report, config:show, config:set, ps:scale, ps:report, logs, plugin:list, plugin:install, plugin:uninstall, plugin:enable, plugin:disable, plugin:update, version, proxy:report, proxy:set, scheduler:report, scheduler:set, git:report, git:set, ssh-keys:list, ssh-keys:remove, registry:logout, logs:set.
• Missing/partial: ssh-keys:add, registry:login/registry listing, configuration key enumeration, Services plugin, SSL plugin, streaming/attach sessions.