Dokploy MCP server
✓ 인증됨AI 클라이언트가 컴팩트하고 토큰 효율적인 인터페이스를 통해 Dokploy 배포, 데이터베이스, 도메인 및 로그를 관리할 수 있도록 지원합니다.
다른 이름 vcode-sh/dokploy-mcp, dokploy-mcp, @vibetools/dokploy-mcp
- 스타
- 4
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 4.0.0
- 마지막 커밋
- 2026년 7월 9일
- 라이선스
- MIT
Dokploy MCP란?
Dokploy은(는) MCP server입니다. AI 클라이언트가 컴팩트하고 토큰 효율적인 인터페이스를 통해 Dokploy 배포, 데이터베이스, 도메인 및 로그를 관리할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Dokploy MCP server 정보
Dokploy MCP는 Claude Desktop, Cursor, Codex, Claude Code와 같은 AI 클라이언트가 Dokploy PaaS와 상호작용할 수 있는 방법을 제공합니다. 컨텍스트 윈도우로 전송되는 토큰 수를 크게 줄이는 컴팩트한 인터페이스를 사용하여 효율성에 집중합니다. 수백 개의 개별 엔드포인트 스키마를 노출하는 대신 search, execute, list_profiles라는 세 가지 주요 도구를 사용합니다. 이러한 방식을 통해 서버는 작은 점유율을 유지하면서도 수백 개의 내부 절차를 관리할 수 있습니다.
사용자는 Dokploy 설정에서 가져온 DOKPLOY_URL과 DOKPLOY_API_KEY를 사용하여 npx를 통해 서버를 설정합니다. 이 서버는 로컬 stdio 연결과 호스팅된 HTTP 메타데이터를 지원합니다. 여러 조직을 관리하는 개발자의 경우, DOKPLOY_PROFILES_JSON 환경 변수를 통해 이름이 지정된 여러 프로필을 구성할 수 있습니다. 이를 통해 AI가 execute 도구에 프로필 이름을 전달하여 서로 다른 Dokploy 인스턴스 간을 전환할 수 있으며, 민감한 자격 증명을 노출하지 않고도 배포, 데이터베이스, 도메인 및 로그에 대한 복잡한 워크플로우를 용이하게 수행할 수 있습니다.
활용 사례
- 1여러 Dokploy 계정 관리이름이 지정된 프로필을 사용하여 AI가 특정 조직에서 작업을 수행하도록 지시합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Dokploy MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Dokploy MCP 설치
$ claude mcp add --env 'DOKPLOY_API_KEY=<YOUR_DOKPLOY_API_KEY>' --env 'DOKPLOY_PROFILES_JSON=<YOUR_DOKPLOY_PROFILES_JSON>' dokploy-mcp -- npx -y @vibetools/dokploy-mcpCursor에 Dokploy MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"dokploy-mcp": {
"command": "npx",
"args": [
"-y",
"@vibetools/dokploy-mcp"
],
"env": {
"DOKPLOY_API_KEY": "<YOUR_DOKPLOY_API_KEY>",
"DOKPLOY_PROFILES_JSON": "<YOUR_DOKPLOY_PROFILES_JSON>"
}
}
}
}VS Code에 Dokploy MCP 설치
.vscode/mcp.json
{
"servers": {
"dokploy-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vibetools/dokploy-mcp"
],
"env": {
"DOKPLOY_API_KEY": "<YOUR_DOKPLOY_API_KEY>",
"DOKPLOY_PROFILES_JSON": "<YOUR_DOKPLOY_PROFILES_JSON>"
}
}
}
}VS Code CLI에 Dokploy MCP 설치
$ code --add-mcp '{"name":"dokploy-mcp","type":"stdio","command":"npx","args":["-y","@vibetools/dokploy-mcp"],"env":{"DOKPLOY_API_KEY":"<YOUR_DOKPLOY_API_KEY>","DOKPLOY_PROFILES_JSON":"<YOUR_DOKPLOY_PROFILES_JSON>"}}'Claude Desktop에 Dokploy MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"dokploy-mcp": {
"command": "npx",
"args": [
"-y",
"@vibetools/dokploy-mcp"
],
"env": {
"DOKPLOY_API_KEY": "<YOUR_DOKPLOY_API_KEY>",
"DOKPLOY_PROFILES_JSON": "<YOUR_DOKPLOY_PROFILES_JSON>"
}
}
}
}Codex에 Dokploy MCP 설치
$ codex mcp add dokploy-mcp --env 'DOKPLOY_API_KEY=<YOUR_DOKPLOY_API_KEY>' --env 'DOKPLOY_PROFILES_JSON=<YOUR_DOKPLOY_PROFILES_JSON>' -- npx -y @vibetools/dokploy-mcpCodex config.toml에 Dokploy MCP 설치
~/.codex/config.toml
[mcp_servers.dokploy-mcp] command = "npx" args = ["-y", "@vibetools/dokploy-mcp"] [mcp_servers.dokploy-mcp.env] DOKPLOY_API_KEY = "<YOUR_DOKPLOY_API_KEY>" DOKPLOY_PROFILES_JSON = "<YOUR_DOKPLOY_PROFILES_JSON>"
Gemini CLI에 Dokploy MCP 설치
$ gemini mcp add -s user -e 'DOKPLOY_API_KEY=<YOUR_DOKPLOY_API_KEY>' -e 'DOKPLOY_PROFILES_JSON=<YOUR_DOKPLOY_PROFILES_JSON>' dokploy-mcp npx -- -y @vibetools/dokploy-mcpGemini settings.json에 Dokploy MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"dokploy-mcp": {
"command": "npx",
"args": [
"-y",
"@vibetools/dokploy-mcp"
],
"env": {
"DOKPLOY_API_KEY": "<YOUR_DOKPLOY_API_KEY>",
"DOKPLOY_PROFILES_JSON": "<YOUR_DOKPLOY_PROFILES_JSON>"
}
}
}
}구성
DOKPLOY_API_KEY비밀Optional when local Dokploy credentials already exist. Otherwise provide the Dokploy API key.
DOKPLOY_PROFILES_JSON비밀Optional JSON object of named Dokploy targets. Use this when you want explicit named profiles in addition to the local default target.
DOKPLOY_URLOptional when local Dokploy credentials already exist. Otherwise provide the Dokploy panel URL.
| 이름 | 설명 | 유형 |
|---|---|---|
| DOKPLOY_API_KEY | Optional when local Dokploy credentials already exist. Otherwise provide the Dokploy API key. | 비밀 |
| DOKPLOY_PROFILES_JSON | Optional JSON object of named Dokploy targets. Use this when you want explicit named profiles in addition to the local default target. | 비밀 |
| DOKPLOY_URL | Optional when local Dokploy credentials already exist. Otherwise provide the Dokploy panel URL. |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능vcode-sh/dokploy-mcp is public and reachablegithub.com/vcode-sh/dokploy-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시@vibetools/dokploy-mcp names vcode-sh/dokploy-mcp as sourcenpmjs.com/package/@vibetools/dokploy-mcp ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @vibetools/dokploy-mcpnpmjs.com/package/@vibetools/dokploy-mcp/v/4.0.0#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-07-09github.com/vcode-sh/dokploy-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @vibetools/dokploy-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음105 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답Endpoint did not answer initialize: unreachable결함 발견
README
GitHub에서 보기@vibetools/dokploy-mcp
MCP server for Dokploy that works cleanly with Codex, Cursor, Claude Code, and Claude Desktop.
Three tools up front. Hundreds of Dokploy procedures underneath. Less schema tax, more actual deploys.
Most MCP servers treat your context window like free landfill. This one starts with
search, execute, and list_profiles, then earns the rest.
What that buys you:
- compact default surface instead of hundreds of raw endpoint tools
- generated, broad Dokploy coverage underneath
- real workflows for deploys, compose, logs, domains, databases, and profiles
- local
stdioplus hosted HTTP metadata in the same package
Need proof instead of a sales monologue? Start with docs/live-e2e-proof.md.
Current Fact Snapshot
- Generated API procedures in the pinned catalog:
544 - Generated tags:
50 - Default public MCP tools:
3(search,execute,list_profiles) - Default
tools/listfootprint from the current budget check: about1,681tokens (6,723bytes) - Reduction versus the classic endpoint-per-tool baseline (
92,354tokens):98.2%
| Classic endpoint-per-tool baseline | Current Code Mode default | |
|---|---|---|
| Tool definitions sent | about 92,354 tokens |
about 1,681 tokens |
| Public MCP tools | hundreds of endpoint schemas | 3 |
| Context window tax | wide schema dump | compact fixed surface |
Quick Start
Get your API key from Dokploy Settings > Profile > API/CLI.
For env-based setup, start from .env.example.
If your client uses a JSON-style MCP config, this is the whole block:
{
"mcpServers": {
"dokploy": {
"command": "npx",
"args": ["@vibetools/dokploy-mcp"],
"env": {
"DOKPLOY_URL": "https://panel.example.com",
"DOKPLOY_API_KEY": "dokp_..."
}
}
}
}
If your client uses CLI-based MCP management:
# Codex
codex mcp add dokploy \
--env DOKPLOY_URL=https://panel.example.com \
--env DOKPLOY_API_KEY=dokp_... \
-- npx @vibetools/dokploy-mcp
# Claude Code
claude mcp add --transport stdio \
-e DOKPLOY_URL=https://panel.example.com \
-e DOKPLOY_API_KEY=dokp_... \
dokploy -- npx @vibetools/dokploy-mcp
Already authenticated with the Dokploy CLI or local
dokploy-mcp config?
You may not need the env block at all.
Using multiple Dokploy organizations?
Keep one compact MCP server and configure profiles with DOKPLOY_PROFILES_JSON:
{
"mcpServers": {
"dokploy": {
"command": "npx",
"args": ["@vibetools/dokploy-mcp"],
"env": {
"DOKPLOY_PROFILES_JSON": "{\"redivo\":{\"url\":\"https://redivo.example.com\",\"apiKey\":\"dokp_redivo\"},\"personal\":{\"url\":\"https://personal.example.com\",\"apiKey\":\"dokp_personal\"},\"mezon\":{\"url\":\"https://mezon.example.com\",\"apiKey\":\"dokp_mezon\"}}"
}
}
}
}
Use list_profiles to see the available default and named profile targets without exposing API
keys. Pass profile to execute when you want a named profile instead of the default target:
{
"profile": "redivo",
"code": "return await dokploy.project.all()"
}
search also accepts an optional profile argument for profile-name validation while preserving
the same compact catalog behavior.
Hosted HTTP sessions keep their request-scoped remote credentials bound to the session. Named local profiles are not exposed there.
Want the wizard path instead of manual config?
npx @vibetools/dokploy-mcp setup
Pick Your Client
What You Actually Get
search: discover Dokploy procedures and contractsexecute: run multi-step workflows in one sandboxed calllist_profiles: list configured Dokploy profile names and URLs without secrets- optional
rawmode: one tool per procedure - optional
hybridmode: Code Mode plus selected raw tools - optional hosted HTTP path with
server.jsonmetadata and header-based remote auth
If you are new, use the default mode and stop trying to outsmart a problem that already has a working shape.
Read These Next
- docs/getting-started.md
- docs/guides/profiles.md
- docs/guides/modes.md
- docs/guides/compose.md
- docs/guides/hosted-http.md
- docs/guides/hosted-deploy.md
- docs/guides/troubleshooting.md
- docs/live-e2e-proof.md
CLI
npx @vibetools/dokploy-mcp
npx @vibetools/dokploy-mcp serve-stdio
npx @vibetools/dokploy-mcp serve-http
npx @vibetools/dokploy-mcp setup
npx @vibetools/dokploy-mcp version
Development
git clone https://github.com/vcode-sh/dokploy-mcp.git && cd dokploy-mcp
npm install
npm run build
npm run lint
npm test
npm run docs:check:facts
The rest lives in docs, where it belongs.
Credits
Forked from Dokploy/mcp. Started at 67 tools, mass-refactored to 377, then rebuilt the whole thing into an architecture that makes the tool count irrelevant.
Mauricio Siu built Dokploy itself -- the PaaS this server talks to. Without the platform, this is a very elaborate way to POST into the void.
Henrique Andrade wrote the original MCP server. 15 commits, every PR merged. The kind of contributor who closes issues instead of opening them.
Contributors who shaped the original: Joshua Macauley -- lucasleal-developer -- Nour Eddine Hamaidi -- Corey -- Azil0ne
Unmerged PRs are still blueprints. That's how open source works -- stolen inspiration with better commit messages.
License
MIT - Vibe Code
Original work by Henrique Andrade under Apache 2.0 -- see LICENSE-ORIGINAL.
Dokploy MCP 질문
Dokploy MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'DOKPLOY_API_KEY=<YOUR_DOKPLOY_API_KEY>' --env 'DOKPLOY_PROFILES_JSON=<YOUR_DOKPLOY_PROFILES_JSON>' dokploy-mcp -- npx -y @vibetools/dokploy-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Dokploy MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
API 키는 어디에서 찾을 수 있나요?
API 키는 Dokploy 대시보드의 Settings > Profile > API/CLI 메뉴에서 확인할 수 있습니다.
여러 Dokploy 조직을 관리할 수 있나요?
네, DOKPLOY_PROFILES_JSON 환경 변수를 사용하여 여러 프로필을 구성하고 대상 간에 전환할 수 있습니다.
기본적으로 어떤 도구를 사용할 수 있나요?
이 MCP server는 search, execute, list_profiles 세 가지 기본 공개 도구를 제공합니다.