Skip to main content
Glama
deenesjakoruzh
jarciahdz111

Dokploy MCP Server

by jarciahdz111
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Dokploy MCP 서버

npm version license Node.js

Dokploy API를 100% 지원하는 MCP 서버입니다. Dokploy OpenAPI 사양에서 자동 생성된 463개의 도구를 제공합니다. Claude에서 직접 프로젝트, 애플리케이션, 데이터베이스, Docker Compose 스택 등을 관리하세요.

요구 사항

  • Node.js 18+ (node -v로 확인)

  • API 액세스 권한이 있는 Dokploy 계정

  • Dokploy 대시보드의 Settings → API Keys에서 발급받은 API 키

빠른 시작

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 도구를 사용할 수 있게 됩니다.

환경 변수

변수

설명

필수

기본값

DOKPLOY_URL

Dokploy API URL (예: https://cloud.dokploy.com/api)

예

—

DOKPLOY_API_KEY

Dokploy Settings → API Keys에서 발급받은 API 키

예

—

REQUEST_TIMEOUT_MS

HTTP 요청 시간 제한 (밀리초 단위)

아니요

30000

DEBUG

1로 설정 시 디버그 로깅 활성화 (JSON을 stderr로 출력)

아니요

—

사용 가능한 도구

42개 카테고리에 걸친 463개의 도구입니다. 도구 이름은 dokploy_{category}_{action} 패턴을 따릅니다.

카테고리

도구 수

설명

admin

1

관리자 작업

ai

9

AI 기반 기능

application

29

애플리케이션 배포 및 관리

auditLog

1

감사 로그 액세스

backup

11

백업 구성 및 실행

bitbucket

7

Bitbucket 통합

certificate

4

SSL 인증서 관리

cluster

4

클러스터 관리

compose

28

Docker Compose 스택 작업

customRole

6

사용자 지정 역할 권한

deployment

8

배포 작업

destination

6

배포 대상

docker

7

컨테이너 및 이미지 관리

domain

9

도메인 관리

environment

7

환경 변수

gitea

8

Gitea 통합

gitProvider

2

일반 Git 제공자

github

6

GitHub 통합

gitlab

7

GitLab 통합

licenseKey

6

라이선스 관리

mariadb

14

MariaDB 데이터베이스 관리

mongo

14

MongoDB 데이터베이스 관리

mounts

6

볼륨 마운트

mysql

14

MySQL 데이터베이스 관리

notification

38

Slack, 이메일, Discord 알림

organization

11

조직 관리

patch

12

패치 관리

port

4

포트 구성

postgres

14

PostgreSQL 데이터베이스 관리

previewDeployment

4

미리보기 배포

project

8

프로젝트 및 환경 관리

redis

14

Redis 캐시 관리

redirects

4

리다이렉트 규칙

registry

7

Docker 레지스트리 관리

rollback

2

배포 롤백

schedule

6

예약된 작업

security

4

보안 설정

server

16

서버 프로비저닝 및 관리

settings

49

서버 및 애플리케이션 설정

sso

10

SSO/OIDC/SAML 구성

sshKey

6

SSH 키 관리

stripe

7

Stripe 결제

swarm

3

Docker Swarm 모드

user

20

사용자 및 세션 관리

volumeBackups

6

볼륨 백업 관리

whitelabeling

4

화이트레이블 구성

사용 예시

모든 프로젝트 나열

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. Dokploy 대시보드의 Settings → API Keys로 이동합니다.

  2. 새 API 키를 생성합니다.

  3. Claude Desktop 구성에서 DOKPLOY_API_KEY를 업데이트합니다.

  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"
      }
    }
  }
}

디버그 출력은 JSON 형식으로 stderr에 기록됩니다.

작동 원리

이 MCP 서버는 Dokploy OpenAPI 사양에서 자동 생성됩니다. Dokploy가 API 업데이트를 릴리스하면, 수동으로 도구를 작성할 필요 없이 업데이트된 도구 범위를 포함하여 이 패키지의 새 버전을 게시할 수 있습니다.

서버 작동 방식:

  1. 내장된 OpenAPI 사양(1.4MB, 463개 엔드포인트)을 로드합니다.

  2. 각 엔드포인트를 Zod로 검증된 입력 스키마를 가진 MCP 도구로 변환합니다.

  3. GET 요청을 tRPC 쿼리로, POST 요청을 tRPC 뮤테이션으로 라우팅합니다.

  4. tRPC 응답 래핑 및 오류 파싱을 자동으로 처리합니다.

API 지원 범위

  • Dokploy API v0.28.8 엔드포인트 100% 지원

  • 463개의 MCP 도구

  • 42개의 기능 카테고리

  • API 사양과 자동 생성 및 자동 동기화

기여

이 MCP 서버를 수정하거나 확장하고 싶으신가요? 개발 워크플로우, 아키텍처 개요 및 기여 가이드라인은 CLAUDE.md를 참조하세요.

라이선스

MIT

Install Server
A
security – no known vulnerabilities
A
license - permissive license
C
quality - C tier

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jarciahdz111/dokploy-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server