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個のツールを提供します。プロジェクト、アプリケーション、データベース、Docker ComposeスタックなどをClaudeから直接管理できます。

要件

  • 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_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.4 MB、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