Dokploy MCP Server

MCP-сервер, обеспечивающий 100% покрытие API Dokploy — 463 инструмента, автоматически сгенерированных на основе спецификации OpenAPI Dokploy. Управляйте проектами, приложениями, базами данных, стеками Docker Compose и многим другим прямо из Claude.

Требования

• Node.js 18+ (проверьте с помощью node -v)

• Учетная запись Dokploy с доступом к API

• API-ключ из раздела Settings → API Keys в вашей панели управления Dokploy

Быстрый старт

1. Установка

npm install -g @jarciahdz111/dokploy-mcp

Или запустите без установки:

npx @jarciahdz111/dokploy-mcp

2. Настройка Claude Desktop

Создайте или отредактируйте файл конфигурации Claude Desktop:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Добавьте эту конфигурацию:

{
  "mcpServers": {
    "dokploy": {
      "command": "dokploy-mcp",
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key"
      }
    }
  }
}

3. Настройка Claude Code CLI (опционально)

Если вы используете Claude Code CLI, добавьте это в ~/.claude.json:

{
  "mcpServers": {
    "dokploy": {
      "command": "dokploy-mcp",
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key"
      }
    }
  }
}

4. Перезапуск Claude

Перезапустите Claude Desktop или ваш терминал. 463 инструмента Dokploy станут доступны.

Переменные окружения

Доступные инструменты

463 инструмента в 42 категориях. Имена инструментов следуют шаблону dokploy_{category}_{action}.

Примеры использования

Список всех проектов

dokploy_project_all

Получить контейнеры Docker

dokploy_docker_getContainers

Получить детали приложения

dokploy_application_one
// arguments: { applicationId: "your-application-id" }

Развернуть приложение

dokploy_application_deploy
// arguments: { applicationId: "your-application-id", to: "production" }

Список баз данных PostgreSQL

dokploy_postgres_all

Получить статус сервера

dokploy_settings_getDokployVersion

Перезапустить контейнер Docker

dokploy_docker_restartContainer
// arguments: { containerId: "your-container-id" }

Локальная разработка

# Clone the repository
git clone https://github.com/jarciahdz111/dokploy-mcp.git
cd dokploy-mcp

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Test
node test-mcp.js

Устранение неполадок

Ошибка "Unauthorized"

Ваш DOKPLOY_API_KEY недействителен или истек.

1. Перейдите в Settings → API Keys в вашей панели Dokploy

2. Создайте новый API-ключ

3. Обновите DOKPLOY_API_KEY в конфигурации Claude Desktop

4. Перезапустите Claude

Ошибка "Connection Refused"

Сервер не может связаться с вашим экземпляром Dokploy.

1. Проверьте, что DOKPLOY_URL указан верно (должен заканчиваться на /api)

2. Убедитесь, что сервер Dokploy запущен и доступен

3. Если вы находитесь за корпоративным брандмауэром, установите переменные окружения прокси:

export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080

Ошибка Request Timeout

Запрос выполнялся слишком долго и был прерван.

Увеличьте тайм-аут, установив REQUEST_TIMEOUT_MS:

{
  "mcpServers": {
    "dokploy": {
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key",
        "REQUEST_TIMEOUT_MS": "60000"
      }
    }
  }
}

Включение отладочного логирования

Чтобы увидеть подробные логи запросов/ответов:

{
  "mcpServers": {
    "dokploy": {
      "env": {
        "DOKPLOY_URL": "https://your-dokploy.com/api",
        "DOKPLOY_API_KEY": "your-api-key",
        "DEBUG": "1"
      }
    }
  }
}

Отладочный вывод записывается в stderr в формате JSON.

Как это работает

Этот MCP-сервер автоматически генерируется на основе спецификации OpenAPI Dokploy. Когда Dokploy выпускает обновление API, новая версия этого пакета может быть опубликована с обновленным покрытием инструментов — ручное написание инструментов не требуется.

Сервер:

1. Загружает встроенную спецификацию OpenAPI (1.4 МБ, 463 эндпоинта)

2. Преобразует каждый эндпоинт в инструмент MCP со схемой ввода, проверенной Zod

3. Маршрутизирует GET-запросы как tRPC-запросы, а POST-запросы как tRPC-мутации

4. Автоматически обрабатывает обертку ответов tRPC и разбор ошибок

Покрытие API

• 100% эндпоинтов Dokploy API v0.28.8

• 463 инструмента MCP

• 42 функциональные категории

• Автоматическая генерация и синхронизация со спецификацией API

Участие в разработке

Хотите изменить или расширить этот MCP-сервер? См. CLAUDE.md для ознакомления с рабочим процессом разработки, обзором архитектуры и рекомендациями по внесению вклада.

Лицензия

MIT