mcp-dokploy-fullapi-proxy 1.0.1 → 1.0.3

package/README.md

@@ -1,6 +1,6 @@
 # mcp-dokploy-fullapi-proxy
 
-> **Dokploy Version: `v0.28.1` — 436 Endpoints** _(last updated: 2026-02-28)_
+> **Dokploy Version: `v0.28.2` — 445 Endpoints** _(last updated: 2026-03-02)_
 
 Full API proxy MCP for the entire Dokploy API. **1 tool, ~200 tokens** instead of 67+ tools consuming ~35,000 tokens per conversation.
 
@@ -11,10 +11,7 @@ A single MCP tool `dokploy(method, params?)` acts as a thin proxy to Dokploy's t
 ## Setup
 
 ```bash
-git clone https://github.com/hl9020/mcp-dokploy-fullapi-proxy.git
-cd mcp-dokploy-fullapi-proxy
-npm install
-npm run build
+npx -y mcp-dokploy-fullapi-proxy
 ```
 
 ## Configuration
@@ -41,8 +38,8 @@ Add to `claude_desktop_config.json`:
 {
   "mcpServers": {
     "dokploy-fullapi-proxy": {
-      "command": "node",
-      "args": ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-dokploy-fullapi-proxy"],
       "env": {
         "DOKPLOY_URL": "https://your-dokploy-instance.com/api",
         "DOKPLOY_TOKEN": "your-api-token"
@@ -73,7 +70,7 @@ Get your API token from Dokploy: **Settings → Profile → API/Token Section**.
 claude mcp add dokploy-fullapi-proxy \
   -e DOKPLOY_URL=https://your-dokploy-instance.com/api \
   -e DOKPLOY_TOKEN=your-api-token \
-  -- node /path/to/mcp-dokploy-fullapi-proxy/dist/index.js
+  -- npx -y mcp-dokploy-fullapi-proxy
 ```
 
 Or add to `.mcp.json` in your project root (Windows: use `cmd /c` wrapper):
@@ -82,8 +79,8 @@ Or add to `.mcp.json` in your project root (Windows: use `cmd /c` wrapper):
 {
   "mcpServers": {
     "dokploy-fullapi-proxy": {
-      "command": "node",
-      "args": ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-dokploy-fullapi-proxy"],
       "env": {
         "DOKPLOY_URL": "https://your-dokploy-instance.com/api",
         "DOKPLOY_TOKEN": "your-api-token"
@@ -118,8 +115,8 @@ Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):
 {
   "mcpServers": {
     "dokploy-fullapi-proxy": {
-      "command": "node",
-      "args": ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-dokploy-fullapi-proxy"],
       "env": {
         "DOKPLOY_URL": "https://your-dokploy-instance.com/api",
         "DOKPLOY_TOKEN": "your-api-token"
@@ -164,8 +161,8 @@ Add to `~/.codeium/windsurf/mcp_config.json` (Windows: `%USERPROFILE%\.codeium\w
 {
   "mcpServers": {
     "dokploy-fullapi-proxy": {
-      "command": "node",
-      "args": ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-dokploy-fullapi-proxy"],
       "env": {
         "DOKPLOY_URL": "https://your-dokploy-instance.com/api",
         "DOKPLOY_TOKEN": "your-api-token"
@@ -202,8 +199,8 @@ Add to `.vscode/mcp.json` in your workspace:
 {
   "servers": {
     "dokploy-fullapi-proxy": {
-      "command": "node",
-      "args": ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-dokploy-fullapi-proxy"],
       "env": {
         "DOKPLOY_URL": "https://your-dokploy-instance.com/api",
         "DOKPLOY_TOKEN": "your-api-token"
@@ -231,8 +228,8 @@ Open Cline → **MCP Servers** icon → **Edit MCP Settings**, then add:
 {
   "mcpServers": {
     "dokploy-fullapi-proxy": {
-      "command": "node",
-      "args": ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-dokploy-fullapi-proxy"],
       "env": {
         "DOKPLOY_URL": "https://your-dokploy-instance.com/api",
         "DOKPLOY_TOKEN": "your-api-token"
@@ -260,8 +257,8 @@ Create `.continue/mcpServers/dokploy.json`:
 {
   "mcpServers": {
     "dokploy-fullapi-proxy": {
-      "command": "node",
-      "args": ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-dokploy-fullapi-proxy"],
       "env": {
         "DOKPLOY_URL": "https://your-dokploy-instance.com/api",
         "DOKPLOY_TOKEN": "your-api-token"
@@ -287,15 +284,15 @@ Add a `.continue/rules/dokploy.md` rule with the contents of `skill/SKILL.md`. C
 codex mcp add dokploy-fullapi-proxy \
   --env DOKPLOY_URL=https://your-dokploy-instance.com/api \
   --env DOKPLOY_TOKEN=your-api-token \
-  -- node /path/to/mcp-dokploy-fullapi-proxy/dist/index.js
+  -- npx -y mcp-dokploy-fullapi-proxy
 ```
 
 Or add to `~/.codex/config.toml` (global) or `.codex/config.toml` (project):
 
 ```toml
 [mcp_servers.dokploy-fullapi-proxy]
-command = "node"
-args = ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"]
+command = "npx"
+args = ["-y", "mcp-dokploy-fullapi-proxy"]
 
 [mcp_servers.dokploy-fullapi-proxy.env]
 DOKPLOY_URL = "https://your-dokploy-instance.com/api"
@@ -329,8 +326,8 @@ Add to Zed `settings.json` (via **Agent Panel → Settings**):
   "context_servers": {
     "dokploy-fullapi-proxy": {
       "command": {
-        "path": "node",
-        "args": ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"],
+        "path": "npx",
+        "args": ["-y", "mcp-dokploy-fullapi-proxy"],
         "env": {
           "DOKPLOY_URL": "https://your-dokploy-instance.com/api",
           "DOKPLOY_TOKEN": "your-api-token"
@@ -359,8 +356,8 @@ Add to `~/.gemini/settings.json` or via **Antigravity Settings → MCP**:
 {
   "mcpServers": {
     "dokploy-fullapi-proxy": {
-      "command": "node",
-      "args": ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-dokploy-fullapi-proxy"],
       "env": {
         "DOKPLOY_URL": "https://your-dokploy-instance.com/api",
         "DOKPLOY_TOKEN": "your-api-token"
@@ -388,8 +385,8 @@ Configure via Roo Code's MCP settings panel, same JSON format as Cline:
 {
   "mcpServers": {
     "dokploy-fullapi-proxy": {
-      "command": "node",
-      "args": ["/path/to/mcp-dokploy-fullapi-proxy/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "mcp-dokploy-fullapi-proxy"],
       "env": {
         "DOKPLOY_URL": "https://your-dokploy-instance.com/api",
         "DOKPLOY_TOKEN": "your-api-token"
@@ -432,11 +429,11 @@ The `skill/` directory contains API documentation split by resource (auto-genera
 | File | Endpoints | Coverage |
 |------|-----------|----------|
 | `SKILL.md` | – | Entry point, routing table |
-| `project.md` | 12 | Projects & Environments |
-| `app.md` | 28 | Applications |
-| `compose.md` | 27 | Compose services |
+| `project.md` | 14 | Projects & Environments |
+| `app.md` | 29 | Applications |
+| `compose.md` | 28 | Compose services |
 | `domain.md` | 9 | Domains & SSL |
-| `database.md` | 65 | PostgreSQL, MySQL, MariaDB, MongoDB, Redis |
+| `database.md` | 70 | PostgreSQL, MySQL, MariaDB, MongoDB, Redis |
 | `deployment.md` | 12 | Deployments, Preview, Rollback |
 | `docker.md` | 7 | Docker containers |
 | `server.md` | 23 | Server, Cluster, Swarm |
@@ -452,7 +449,7 @@ The `skill/` directory contains API documentation split by resource (auto-genera
 |---|---|---|
 | Tools registered | 67 | 1 |
 | Permanent context tokens | ~35,000 | ~200 |
-| API coverage | ~16% (67 of 436 endpoints) | 100% (436 endpoints) |
+| API coverage | ~16% (67 of 436 endpoints) | 100% (445 endpoints) |
 | On-demand tokens per request | 0 | ~500–2,000 (1 skill file) |
 | Typical savings | – | **77–92% fewer tokens** |
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-dokploy-fullapi-proxy",
-  "version": "1.0.1",
-  "description": "Full API proxy MCP for the entire Dokploy API – single tool, skill-driven, 407 endpoints",
+  "version": "1.0.3",
+  "description": "Full API proxy MCP for the entire Dokploy API - single tool, skill-driven, 445 endpoints",
   "type": "module",
   "main": "dist/index.js",
   "scripts": {

package/skill/SKILL.md

@@ -4,7 +4,7 @@ description: >
   Use this skill when the user asks to manage Dokploy infrastructure: deploy apps,
   manage compose services, configure domains, databases, servers, notifications,
   users, git providers, or any Dokploy administration task. Provides complete API
-  reference for all 436 Dokploy tRPC endpoints accessible via the dokploy MCP tool.
+  reference for all 445 Dokploy tRPC endpoints accessible via the dokploy MCP tool.
 ---
 
 # Dokploy MCP Light - API Skill
@@ -19,11 +19,11 @@ Read the matching reference file for the task:
 
 | Task | File | Endpoints |
 |------|------|-----------|
-| Projects & Environments | `project.md` | 12 |
-| Applications (Deploy, Config, Git, Traefik) | `app.md` | 28 |
-| Compose Services | `compose.md` | 27 |
+| Projects & Environments | `project.md` | 14 |
+| Applications (Deploy, Config, Git, Traefik) | `app.md` | 29 |
+| Compose Services | `compose.md` | 28 |
 | Domains & SSL | `domain.md` | 9 |
-| Databases (PG, MySQL, MariaDB, Mongo, Redis) | `database.md` | 65 |
+| Databases (PG, MySQL, MariaDB, Mongo, Redis) | `database.md` | 70 |
 | Deployments, Preview, Rollback | `deployment.md` | 12 |
 | Docker Container | `docker.md` | 7 |
 | Server, Cluster, Swarm | `server.md` | 23 |

package/skill/app.md

@@ -142,3 +142,8 @@ dokploy("application.move", { applicationId: "...", targetEnvironmentId: "..." }
 ```
 dokploy("application.cancelDeployment", { applicationId: "..." })
 ```
+
+### application.search
+```
+dokploy("application.search", { q?: "...", name?: "...", appName?: "...", description?: "...", repository?: "...", owner?: "...", dockerImage?: "...", projectId?: "...", environmentId?: "...", limit?: "...", offset?: "..." })
+```

package/skill/compose.md

@@ -137,3 +137,8 @@ dokploy("compose.import", { base64: "...", composeId: "..." })
 ```
 dokploy("compose.cancelDeployment", { composeId: "..." })
 ```
+
+### compose.search
+```
+dokploy("compose.search", { q?: "...", name?: "...", appName?: "...", description?: "...", projectId?: "...", environmentId?: "...", limit?: "...", offset?: "..." })
+```

package/skill/database.md

@@ -70,6 +70,11 @@ dokploy("postgres.move", { postgresId: "...", targetEnvironmentId: "..." })
 dokploy("postgres.rebuild", { postgresId: "..." })
 ```
 
+### postgres.search
+```
+dokploy("postgres.search", { q?: "...", name?: "...", appName?: "...", description?: "...", projectId?: "...", environmentId?: "...", limit?: "...", offset?: "..." })
+```
+
 ## Mysql
 
 ### mysql.create
@@ -137,6 +142,11 @@ dokploy("mysql.move", { mysqlId: "...", targetEnvironmentId: "..." })
 dokploy("mysql.rebuild", { mysqlId: "..." })
 ```
 
+### mysql.search
+```
+dokploy("mysql.search", { q?: "...", name?: "...", appName?: "...", description?: "...", projectId?: "...", environmentId?: "...", limit?: "...", offset?: "..." })
+```
+
 ## Mariadb
 
 ### mariadb.create
@@ -204,6 +214,11 @@ dokploy("mariadb.move", { mariadbId: "...", targetEnvironmentId: "..." })
 dokploy("mariadb.rebuild", { mariadbId: "..." })
 ```
 
+### mariadb.search
+```
+dokploy("mariadb.search", { q?: "...", name?: "...", appName?: "...", description?: "...", projectId?: "...", environmentId?: "...", limit?: "...", offset?: "..." })
+```
+
 ## Mongo
 
 ### mongo.create
@@ -271,6 +286,11 @@ dokploy("mongo.move", { mongoId: "...", targetEnvironmentId: "..." })
 dokploy("mongo.rebuild", { mongoId: "..." })
 ```
 
+### mongo.search
+```
+dokploy("mongo.search", { q?: "...", name?: "...", appName?: "...", description?: "...", projectId?: "...", environmentId?: "...", limit?: "...", offset?: "..." })
+```
+
 ## Redis
 
 ### redis.create
@@ -337,3 +357,8 @@ dokploy("redis.move", { redisId: "...", targetEnvironmentId: "..." })
 ```
 dokploy("redis.rebuild", { redisId: "..." })
 ```
+
+### redis.search
+```
+dokploy("redis.search", { q?: "...", name?: "...", appName?: "...", description?: "...", projectId?: "...", environmentId?: "...", limit?: "...", offset?: "..." })
+```

package/skill/project.md

@@ -17,6 +17,11 @@ dokploy("project.one", { projectId: "..." })
 dokploy("project.all")
 ```
 
+### project.search
+```
+dokploy("project.search", { q?: "...", name?: "...", description?: "...", limit?: "...", offset?: "..." })
+```
+
 ### project.remove
 ```
 dokploy("project.remove", { projectId: "..." })
@@ -63,3 +68,8 @@ dokploy("environment.update", { environmentId: "...", name?: "...", description?
 ```
 dokploy("environment.duplicate", { environmentId: "...", name: "...", description?: "..." })
 ```
+
+### environment.search
+```
+dokploy("environment.search", { q?: "...", name?: "...", description?: "...", projectId?: "...", limit?: "...", offset?: "..." })
+```