Dokploy MCP

@vibetools/dokploy-mcp

Dokploy 用の MCP サーバーです。Codex、Cursor、Claude Code、 Claude Desktop でスムーズに動作します。

最初から使えるツールは 3 つ。その下には数百もの Dokploy の手順が用意されています。スキーマの負担を減らし、実際のデプロイを増やします。

多くの MCP サーバーは、コンテキストウィンドウを何でも捨てられる場所のように扱います。このサーバーはまず search、execute、list_profiles を提供し、必要に応じて機能を広げていきます。

これにより、次のことが可能になります。

• 数百もの未加工のエンドポイントツールの代わりに、コンパクトなデフォルトのインターフェースを利用できます
• その下では、Dokploy の幅広い API を自動生成してカバーします
• デプロイ、Compose、ログ、ドメイン、データベース、プロファイルに対応した実用的なワークフローを利用できます
• 同じパッケージで、ローカルの stdio とホスト型 HTTP のメタデータを利用できます

宣伝文句ではなく証拠を確認したい場合は、docs/live-e2e-proof.md から始めてください。

現在の事実スナップショット

• 固定カタログ内の生成済み API 手順：544
• 生成済みタグ：50
• デフォルトで公開される MCP ツール：3（search、execute、list_profiles）
• 現在の予算チェックによるデフォルトの tools/list サイズ：約 1,681 トークン（6,723 バイト）
• 従来のエンドポイントごとにツールを用意する方式（92,354 トークン）と比較した削減率：98.2%

	従来のエンドポイントごとにツールを用意する方式	現在の Code Mode のデフォルト
送信されるツール定義	約 92,354 トークン	約 1,681 トークン
公開される MCP ツール	数百のエンドポイントスキーマ	3
コンテキストウィンドウの負担	大量のスキーマダンプ	コンパクトで固定されたインターフェース

クイックスタート

Dokploy Settings > Profile > API/CLI から API キーを取得してください。

環境変数を使ったセットアップは .env.example を参考にしてください。

クライアントが JSON 形式の MCP 設定を使う場合は、次のブロックだけで設定できます。

{
  "mcpServers": {
    "dokploy": {
      "command": "npx",
      "args": ["@vibetools/dokploy-mcp"],
      "env": {
        "DOKPLOY_URL": "https://panel.example.com",
        "DOKPLOY_API_KEY": "dokp_..."
      }
    }
  }
}

クライアントが CLI ベースの MCP 管理を使う場合：

# 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

Dokploy CLI またはローカルの dokploy-mcp 設定ですでに認証済みですか？

環境変数のブロックは不要な場合があります。

複数の Dokploy 組織を利用していますか？

コンパクトな MCP サーバーを 1 つ使い、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\"}}"
      }
    }
  }
}

list_profiles を使うと、API キーを公開せずに、利用可能なデフォルトおよび名前付きプロファイルの接続先を確認できます。デフォルトの接続先ではなく名前付きプロファイルを使う場合は、execute に profile を渡してください。

{
  "profile": "redivo",
  "code": "return await dokploy.project.all()"
}

search でも省略可能な profile 引数を受け付け、同じコンパクトなカタログの動作を保ちながら、プロファイル名を検証できます。

ホスト型 HTTP セッションでは、リクエスト単位のリモート認証情報がセッションに紐付けられます。名前付きのローカルプロファイルは公開されません。

手動設定ではなく、ウィザードを使いたい場合は？

npx @vibetools/dokploy-mcp setup

クライアントを選択

• ドキュメントホーム
• はじめに
• Cursor
• Codex
• Claude Code
• Claude Desktop

実際にできること

• search：Dokploy の手順と契約を検索します
• execute：サンドボックス化された 1 回の呼び出しで、複数ステップのワークフローを実行します
• list_profiles：設定済みの Dokploy プロファイル名と URL を、シークレットを含めずに一覧表示します
• オプションの raw モード：手順ごとに 1 つのツールを提供します
• オプションの hybrid モード：Code Mode と選択した raw ツールを組み合わせます
• server.json メタデータとヘッダーベースのリモート認証を備えた、オプションのホスト型 HTTP 接続

初めて使う場合はデフォルトモードを利用してください。すでにうまく機能する方法があるのに、無理に複雑な解決策を考える必要はありません。

次に読むページ

• 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

開発

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

残りの内容は、本来あるべき場所であるdocsにあります。

クレジット

Dokploy/mcpからフォークしました。67個のツールから始まり、大規模なリファクタリングで377個に増やした後、ツール数が重要でなくなるアーキテクチャへと、全体を再構築しました。

Mauricio Siuは、このサーバーが接続するPaaSであるDokploy自体を構築しました。このプラットフォームがなければ、これは虚無にPOSTするための非常に凝った方法にすぎません。

Henrique Andradeは、オリジナルのMCP サーバーを書きました。15件のコミット、すべてのPRがマージされました。課題を立てるのではなく、解決するタイプのコントリビューターです。

オリジナルを形作ったコントリビューター：Joshua Macauley -- lucasleal-developer -- Nour Eddine Hamaidi -- Corey -- Azil0ne

マージされなかったPRも、今なお設計図です。オープンソースとはそういうものです。より良いコミットメッセージを添えて、着想を借りることです。

ライセンス

MIT - Vibe Code

Henrique Andradeによるオリジナルの成果物はApache 2.0ライセンスです。LICENSE-ORIGINALをご覧ください。