Dokploy Mcp

Dokploy MCP Server

Dokploy 向けの包括的な Model Context Protocol（MCP）サーバーです。利用可能なすべてのエンドポイントを幅広くカバーし、Dokploy API 全体に型安全にアクセスできます。

特長

• 380 個のツールで Dokploy API の機能を 100％カバー
• スマートなツール選択により、コアツールをデフォルトで有効化
• 高度なツールも利用可能ですが、パフォーマンスを考慮してデフォルトでは無効
• 自動生成された OpenAPI 型を使用した型安全な統合
• 環境変数ベースの認証
• 各ツールを別々のファイルに配置するモジュール型アーキテクチャ
• あらゆる HTTP ステータスコードに対応する包括的なエラー処理
• ツール選択を最適化した本番環境対応の MCP サーバー

📋 ツールの全内訳と現在のステータスについては、TOOLS_STATUS.md をご覧ください。

インストール

npx -y dokploy-mcp

設定

次の環境変数を設定してください。

export DOKPLOY_URL="https://your-dokploy-instance.com"
export DOKPLOY_API_KEY="your-api-key-here"

API キーの取得

Dokploy ダッシュボードで API キーを作成できます。

1. Dokploy ダッシュボードで Settings → Profile に移動します
2. /dashboard/settings/profile に移動します
3. 新しい API キーを生成します
4. キーをコピーし、DOKPLOY_API_KEY 環境変数の値として使用します

Claude Desktop での使用方法

Claude Desktop の設定に追加してください。

{
  "mcpServers": {
    "dokploy": {
      "command": "npx",
      "args": ["-y", "dokploy-mcp"],
      "env": {
        "DOKPLOY_URL": "https://your-dokploy-instance.com",
        "DOKPLOY_API_KEY": "your-api-key-here"
      }
    }
  }
}

利用可能なツール

利用可能なすべてのツール、その説明、現在のステータスの一覧については、こちらをご覧ください。

📋 TOOLS_STATUS.md - ステータスと管理手順を含む、ツールの完全なリファレンス

ツール管理

実行時のツール制御

コマンドライン引数または環境変数を使用して、実行時にツールの有効／無効を切り替えられます。

ツールを追加で有効にする

# Enable specific tools or categories
npx -y dokploy-mcp --enable-tools postgres/,application-cancelDeployment

# Enable multiple categories
npx -y dokploy-mcp --enable-tools postgres/,mysql/,notification/

特定のツールを無効にする

# Disable specific tools or categories
XMCP_DISABLE_TOOLS=admin/,application-cancelDeployment npx -y dokploy-mcp

# Disable multiple categories
XMCP_DISABLE_TOOLS=admin/,settings/,stripe/ npx -y dokploy-mcp

Claude Desktop の設定

{
  "mcpServers": {
    "dokploy": {
      "command": "npx",
      "args": ["-y", "dokploy-mcp", "--enable-tools", "postgres/,mysql/"],
      "env": {
        "DOKPLOY_URL": "https://your-dokploy-instance.com",
        "DOKPLOY_API_KEY": "your-api-key-here",
        "XMCP_DISABLE_TOOLS": "admin/,stripe/"
      }
    }
  }
}

ツールのパターン

• カテゴリパターン：postgres/、mysql/、notification/ — カテゴリ全体を有効／無効にします
• 特定のツール：application-cancelDeployment、server-create — 個々のツールを有効／無効にします
• 複数のパターン：カンマで区切ります：postgres/,mysql/,application-cancelDeployment

ツールカテゴリ

ツールカテゴリと現在のステータスの詳細については、TOOLS_STATUS.md をご覧ください。

開発モード

追加のツールを常時有効にするには、各ツールのメタデータにある disabled プロパティを変更してください。

export const metadata: ToolMetadata = {
  name: 'tool-name',
  description: 'Tool description',
  annotations: {
    title: 'Tool Title',
    destructiveHint: false,
    idempotentHint: true,
  },
  disabled: false, // Set to false to enable, true to disable
}

ドキュメント

• TOOLS_STATUS.md - ステータスを含む、380 個すべてのツールの完全な一覧
• API Coverage - 有効／無効なツールの詳細な内訳

開発

# Install dependencies
pnpm install

# Build the project (automatically updates TOOLS_STATUS.md)
pnpm build

# Update tools status manually
pnpm run update-tools-status

# Run in development
pnpm dev

ライセンス

MIT