Dokploy MCPサーバー
✓ 検証済みAIクライアントを通じて、Dokployのデプロイ、データベース、ドメイン、ログをトークン効率の高いコンパクトなインターフェースで管理できます。
別名 vcode-sh/dokploy-mcp, dokploy-mcp, @vibetools/dokploy-mcp
- スター
- 4
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 4.0.0
- 最終コミット
- 2026年7月9日
- ライセンス
- MIT
Dokploy MCPとは
DokployはMCPサーバーです。 AIクライアントを通じて、Dokployのデプロイ、データベース、ドメイン、ログをトークン効率の高いコンパクトなインターフェースで管理できます。.
プロジェクトのREADMEから生成された概要
Dokploy MCP server について
Dokploy MCPは、Claude Desktop、Cursor、Codex、Claude CodeなどのAIクライアントがDokploy PaaSとやり取りするための手段を提供します。コンテキストウィンドウに送信されるトークン数を大幅に削減するコンパクトなインターフェースを採用しており、効率性に重点を置いています。数百もの個別のエンドポイントスキーマを公開する代わりに、search、execute、list_profiles という3つの主要なツールを使用します。このアプローチにより、サーバーは最小限のフットプリントを維持しながら、背後にある数百もの手順を管理することが可能です。
ユーザーは、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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
APIキーはどこにありますか?
APIキーは、Dokployダッシュボードの Settings > Profile > API/CLI にあります。
複数のDokploy組織を管理できますか?
はい、DOKPLOY_PROFILES_JSON 環境変数を使用して複数のプロファイルを設定し、異なるターゲットを切り替えることができます。
デフォルトでどのようなツールが利用可能ですか?
このMCP serverは、search、execute、list_profiles の3つのデフォルトの公開ツールを提供します。