@digitalocean/mcp 0.0.7 → 0.0.11

package/build/logger.js

@@ -5,38 +5,43 @@ function toMessage(...args) {
         .map((arg) => (typeof arg === "object" ? JSON.stringify(arg) : String(arg)))
         .join(" ");
 }
-const logger = {
-    info: (...args) => {
-        const entry = {
-            level: "info",
-            message: toMessage(...args),
-            timestamp: new Date().toISOString(),
-        };
-        process.stdout.write(`${JSON.stringify(entry)}\n`);
-    },
-    error: (...args) => {
-        const entry = {
-            level: "error",
-            message: toMessage(...args),
-            timestamp: new Date().toISOString(),
-        };
-        process.stderr.write(`${JSON.stringify(entry)}\n`);
-    },
-    warn: (...args) => {
-        const entry = {
-            level: "warn",
-            message: toMessage(...args),
-            timestamp: new Date().toISOString(),
-        };
-        process.stderr.write(`${JSON.stringify(entry)}\n`);
-    },
-    debug: (...args) => {
-        const entry = {
-            level: "debug",
-            message: toMessage(...args),
-            timestamp: new Date().toISOString(),
-        };
-        process.stdout.write(`${JSON.stringify(entry)}\n`);
-    },
-};
-exports.default = logger;
+class Logger {
+    static instance = null;
+    server;
+    constructor(options = {}) {
+        this.server = options.server;
+    }
+    static createInstance(options = {}) {
+        if (!Logger.instance) {
+            Logger.instance = new Logger(options);
+        }
+        return Logger.instance;
+    }
+    sendLoggingNotification(level, data) {
+        if (this.server) {
+            this.server?.server.sendLoggingMessage({
+                level,
+                data: data,
+            });
+        }
+        else {
+            process.stdout.write(`${JSON.stringify({ level, data })}\n`);
+        }
+    }
+    info(...args) {
+        this.sendLoggingNotification("info", toMessage(...args));
+    }
+    error(...args) {
+        this.sendLoggingNotification("error", toMessage(...args));
+    }
+    warn(...args) {
+        this.sendLoggingNotification("warning", toMessage(...args));
+    }
+    debug(...args) {
+        this.sendLoggingNotification("debug", toMessage(...args));
+    }
+    createStdioLogger(server) {
+        this.server = server;
+    }
+}
+exports.default = Logger.createInstance();

package/build/server.js

@@ -10,12 +10,15 @@ const DOMcpServer_1 = require("./DOMcpServer");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const logger_1 = __importDefault(require("./logger"));
 const package_json_1 = __importDefault(require("../package.json"));
+const databases_1 = require("./tools/databases");
 function createServer() {
     const server = new DOMcpServer_1.DOMcpServer({
         name: "DigitalOcean MCP Server",
-        version: package_json_1.default.version,
-    });
+        version: "1.0.0",
+    }, { capabilities: { logging: { subscribe: true } } });
+    logger_1.default.createStdioLogger(server);
     (0, app_1.registerAppTools)(server);
+    (0, databases_1.registerDatabaseTools)(server);
     return server;
 }
 function startStdioServer(server) {

package/build/tools/app.js

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RevertAppRollback = exports.CommitAppRollback = exports.ValidateAppRollback = exports.RollbackApp = exports.UpdateAppAlertDestinations = exports.ListAppAlerts = exports.ValidateAppSpec = exports.ListRegions = exports.GetInstanceSizeBySlug = exports.ListInstanceSizes = exports.CancelDeployment = exports.GetDeployment = exports.CreateDeployment = exports.ListDeployments = exports.DownloadLogs = exports.GetDeploymentLogsUrl = exports.RestartApp = exports.DeleteApp = exports.UpdateApp = exports.GetApp = exports.CreateApp = exports.ListApps = void 0;
 exports.registerAppTools = registerAppTools;
 const digitalocean_openapi_yaml_zod_1 = require("../specs/digitalocean-openapi.yaml.zod");
 const api_1 = require("../api");
 const zod_1 = require("zod");
-exports.ListApps = {
+const ListApps = {
     name: "list_apps",
     description: `
     List all apps on your account. Information about the current active
@@ -34,11 +33,14 @@ exports.ListApps = {
         });
         return {
             content,
-            _meta: res,
+            _meta: {
+                links: res.links,
+                meta: res.meta,
+            },
         };
     },
 };
-exports.CreateApp = {
+const CreateApp = {
     name: "create_app",
     description: `
     Create a new app by submitting an app specification. For documentation
@@ -62,7 +64,7 @@ exports.CreateApp = {
         }
     },
 };
-exports.GetApp = {
+const GetApp = {
     name: "get_app",
     description: "Get an app by ID",
     parameters: digitalocean_openapi_yaml_zod_1.get_Apps_get.parameters.shape,
@@ -84,7 +86,7 @@ exports.GetApp = {
         }
     },
 };
-exports.UpdateApp = {
+const UpdateApp = {
     name: "update_app",
     description: `
     Update an existing app by submitting a new app specification. For
@@ -109,7 +111,7 @@ exports.UpdateApp = {
         }
     },
 };
-exports.DeleteApp = {
+const DeleteApp = {
     name: "delete_app",
     description: "Delete an app by ID",
     parameters: digitalocean_openapi_yaml_zod_1.delete_Apps_delete.parameters.shape,
@@ -129,28 +131,6 @@ exports.DeleteApp = {
         }
     },
 };
-exports.RestartApp = {
-    name: "restart_app",
-    description: "Restart an app by ID",
-    parameters: digitalocean_openapi_yaml_zod_1.post_Apps_restart.parameters.shape,
-    cb: async (params, extra) => {
-        try {
-            const { client } = (0, api_1.createClient)(extra);
-            const res = await client.post(`/v2/apps/{app_id}/restart`, params);
-            return {
-                content: [
-                    { type: "text", text: JSON.stringify(res.deployment, null, 2) },
-                ],
-            };
-        }
-        catch (error) {
-            return {
-                content: [{ type: "text", text: `Error restarting app: ${error}` }],
-                isError: true,
-            };
-        }
-    },
-};
 const GetDeploymentLogsUrlSchema = zod_1.z.object({
     deployment_id: zod_1.z
         .string()
@@ -159,10 +139,10 @@ const GetDeploymentLogsUrlSchema = zod_1.z.object({
     type: zod_1.z.enum(["BUILD", "DEPLOY", "RUN", "RUN_RESTARTED"]),
     app_id: zod_1.z.string().describe("The ID of the app."),
 });
-exports.GetDeploymentLogsUrl = {
+const GetDeploymentLogsUrl = {
     name: "get_deployment_logs_url",
     description: `
-    Get the URL of the logs for a deployment. Before fetching the logs, you need to
+    Gets the URL of the logs for a deployment. Before fetching the logs, you need to
     get the URL of the logs. 
   `,
     parameters: GetDeploymentLogsUrlSchema.shape,
@@ -213,7 +193,7 @@ exports.GetDeploymentLogsUrl = {
 const DownloadLogsSchema = zod_1.z.object({
     url: zod_1.z.string().describe("The URL to the bucket containing the logs"),
 });
-exports.DownloadLogs = {
+const DownloadLogs = {
     name: "download_logs",
     description: `
     Give the URL of the logs, download the logs and return them as a string.
@@ -235,7 +215,7 @@ exports.DownloadLogs = {
         }
     },
 };
-exports.ListDeployments = {
+const ListDeployments = {
     name: "list_deployments",
     description: "List all deployments for an app",
     parameters: digitalocean_openapi_yaml_zod_1.get_Apps_list_deployments.parameters.shape,
@@ -269,7 +249,7 @@ exports.ListDeployments = {
         }
     },
 };
-exports.CreateDeployment = {
+const CreateDeployment = {
     name: "create_deployment",
     description: "Create a new deployment for an app",
     parameters: digitalocean_openapi_yaml_zod_1.post_Apps_create_deployment.parameters.shape,
@@ -292,7 +272,7 @@ exports.CreateDeployment = {
         }
     },
 };
-exports.GetDeployment = {
+const GetDeployment = {
     name: "get_deployment",
     description: "Get a deployment by ID",
     parameters: digitalocean_openapi_yaml_zod_1.get_Apps_get_deployment.parameters.shape,
@@ -307,13 +287,15 @@ exports.GetDeployment = {
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `Error getting deployment: ${error}` }],
+                content: [
+                    { type: "text", text: `Error getting deployment: ${error}` },
+                ],
                 isError: true,
             };
         }
     },
 };
-exports.CancelDeployment = {
+const CancelDeployment = {
     name: "cancel_deployment",
     description: "Cancel a deployment by ID",
     parameters: digitalocean_openapi_yaml_zod_1.post_Apps_cancel_deployment.parameters.shape,
@@ -334,7 +316,7 @@ exports.CancelDeployment = {
         }
     },
 };
-exports.ListInstanceSizes = {
+const ListInstanceSizes = {
     name: "list_instance_sizes",
     description: "List all instance sizes for `service`, `worker`, and `job` components supported by App Platform.",
     parameters: undefined,
@@ -367,7 +349,7 @@ exports.ListInstanceSizes = {
         }
     },
 };
-exports.GetInstanceSizeBySlug = {
+const GetInstanceSizeBySlug = {
     name: "get_instance_size_by_slug",
     description: "Retrieve information about a specific instance size slug for `service`,`worker`, and `job` components.",
     parameters: digitalocean_openapi_yaml_zod_1.get_Apps_get_instanceSize.parameters.shape,
@@ -389,7 +371,7 @@ exports.GetInstanceSizeBySlug = {
         }
     },
 };
-exports.ListRegions = {
+const ListRegions = {
     name: "list_app_regions",
     description: "List all regions supported by App Platform.",
     cb: async (extra) => {
@@ -421,7 +403,7 @@ exports.ListRegions = {
         }
     },
 };
-exports.ValidateAppSpec = {
+const ValidateAppSpec = {
     name: "validate_app_spec",
     description: `
     Propose and validate a spec for a new or existing app. The request returns some
@@ -448,7 +430,7 @@ exports.ValidateAppSpec = {
         }
     },
 };
-exports.ListAppAlerts = {
+const ListAppAlerts = {
     name: "list_app_alerts",
     description: `
     List alerts associated to the app and any components. This includes
@@ -477,7 +459,7 @@ exports.ListAppAlerts = {
         }
     },
 };
-exports.UpdateAppAlertDestinations = {
+const UpdateAppAlertDestinations = {
     name: "update_app_alert_destinations",
     description: "Update alert destinations for an app",
     parameters: digitalocean_openapi_yaml_zod_1.post_Apps_assign_alertDestinations.parameters.shape,
@@ -499,7 +481,7 @@ exports.UpdateAppAlertDestinations = {
         }
     },
 };
-exports.RollbackApp = {
+const RollbackApp = {
     name: "rollback_app",
     description: `
     Rollback an app to a previous deployment. A new deployment will be
@@ -526,7 +508,7 @@ exports.RollbackApp = {
         }
     },
 };
-exports.ValidateAppRollback = {
+const ValidateAppRollback = {
     name: "validate_app_rollback",
     description: `
   Check whether an app can be rolled back to a specific deployment. This
@@ -553,7 +535,7 @@ exports.ValidateAppRollback = {
         }
     },
 };
-exports.CommitAppRollback = {
+const CommitAppRollback = {
     name: "commit_app_rollback",
     description: `
   Commit an app rollback. This action permanently applies the rollback and
@@ -580,7 +562,7 @@ exports.CommitAppRollback = {
         }
     },
 };
-exports.RevertAppRollback = {
+const RevertAppRollback = {
     name: "revert_app_rollback",
     description: `
   Revert an app rollback. This action reverts the active rollback by
@@ -607,25 +589,25 @@ exports.RevertAppRollback = {
     },
 };
 function registerAppTools(server) {
-    server.registerTool(exports.ListApps);
-    server.registerTool(exports.CreateApp);
-    server.registerTool(exports.GetApp);
-    server.registerTool(exports.UpdateApp);
-    server.registerTool(exports.DeleteApp);
-    server.registerTool(exports.RestartApp);
-    server.registerTool(exports.DownloadLogs); // Custom tool to download logs
-    server.registerTool(exports.ListDeployments);
-    server.registerTool(exports.CreateDeployment);
-    server.registerTool(exports.GetDeployment);
-    server.registerTool(exports.CancelDeployment);
-    server.registerTool(exports.ListInstanceSizes);
-    server.registerTool(exports.GetInstanceSizeBySlug);
-    server.registerTool(exports.ListRegions);
-    server.registerTool(exports.ValidateAppSpec);
-    server.registerTool(exports.ListAppAlerts);
-    server.registerTool(exports.UpdateAppAlertDestinations);
-    server.registerTool(exports.RollbackApp);
-    server.registerTool(exports.ValidateAppRollback);
-    server.registerTool(exports.CommitAppRollback);
-    server.registerTool(exports.RevertAppRollback);
+    server.registerTool(ListApps);
+    server.registerTool(CreateApp);
+    server.registerTool(GetApp);
+    server.registerTool(UpdateApp);
+    server.registerTool(DeleteApp);
+    server.registerTool(GetDeploymentLogsUrl);
+    server.registerTool(DownloadLogs); // Custom tool to download logs
+    server.registerTool(ListDeployments);
+    server.registerTool(CreateDeployment);
+    server.registerTool(GetDeployment);
+    server.registerTool(CancelDeployment);
+    server.registerTool(ListInstanceSizes);
+    server.registerTool(GetInstanceSizeBySlug);
+    server.registerTool(ListRegions);
+    server.registerTool(ValidateAppSpec);
+    server.registerTool(ListAppAlerts);
+    server.registerTool(UpdateAppAlertDestinations);
+    server.registerTool(RollbackApp);
+    server.registerTool(ValidateAppRollback);
+    server.registerTool(CommitAppRollback);
+    server.registerTool(RevertAppRollback);
 }

package/build/tools/databases.js

@@ -0,0 +1,306 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDatabaseTools = registerDatabaseTools;
+const api_1 = require("../api");
+const digitalocean_openapi_yaml_zod_1 = require("../specs/digitalocean-openapi.yaml.zod");
+const GetDatabaseOptions = {
+    name: "get_database_options",
+    description: `
+    Get a list of all database options available for creating a database cluster.
+    This includes available regions, versions, and sizes for each database engine.
+  `,
+    cb: async (extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/databases/options");
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+                isError: true,
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error getting database options: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+const ListDatabasesCluster = {
+    name: "list_databases_cluster",
+    description: `
+    List all database clusters in your account. This includes information about
+    each cluster's configuration, status, and connection details.
+  `,
+    parameters: digitalocean_openapi_yaml_zod_1.get_Databases_list_clusters.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/databases", params);
+            const databases = res.databases ?? [];
+            if (databases.length === 0) {
+                return {
+                    content: [{ type: "text", text: "No database clusters found" }],
+                    isError: true,
+                };
+            }
+            const content = [];
+            databases.forEach((db) => {
+                content.push({
+                    type: "text",
+                    text: `
+          Database Cluster ID: ${db.id}
+          Name: ${db.name}
+          Engine: ${db.engine}
+          Version: ${db.version}
+          Region: ${db.region}
+          Status: ${db.status}
+          Created At: ${db.created_at}
+          Number of Nodes: ${db.num_nodes}
+          Connection URI: ${db.connection?.uri || "N/A"}
+  `,
+                });
+            });
+            return {
+                content,
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error listing database clusters: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+const CreateDatabaseCluster = {
+    name: "create_database_cluster",
+    description: `Create a new database cluster.`,
+    parameters: digitalocean_openapi_yaml_zod_1.post_Databases_create_cluster.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.post("/v2/databases", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error creating database cluster: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+const GetDatabaseCluster = {
+    name: "get_database_cluster",
+    description: `Get information about a specific database cluster.`,
+    parameters: digitalocean_openapi_yaml_zod_1.get_Databases_get_cluster.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/databases/{database_cluster_uuid}", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error getting database cluster: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+const GetDatabaseClusterCertificate = {
+    name: "get_database_cluster_certificate",
+    description: `Get the certificate for a specific database cluster.`,
+    parameters: digitalocean_openapi_yaml_zod_1.get_Databases_get_ca.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/databases/{database_cluster_uuid}/ca", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting database cluster certificate: ${error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+const ListDatabaseFirewallRules = {
+    name: "list_database_firewall_rules",
+    description: `List all firewall (trusted sources) rules for a specific database cluster.`,
+    parameters: digitalocean_openapi_yaml_zod_1.get_Databases_list_firewall_rules.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/databases/{database_cluster_uuid}/firewall", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing database firewall rules: ${error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+const UpdateDatabaseFirewallRules = {
+    name: "update_database_firewall_rules",
+    description: `Update the firewall (trusted sources) rules for a specific database cluster.`,
+    parameters: digitalocean_openapi_yaml_zod_1.put_Databases_update_firewall_rules.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.put("/v2/databases/{database_cluster_uuid}/firewall", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error updating database firewall rules: ${error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+const ListDatabaseClusterUsers = {
+    name: "list_database_cluster_users",
+    description: `List all users for a specific database cluster.`,
+    parameters: digitalocean_openapi_yaml_zod_1.get_Databases_list_users.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/databases/{database_cluster_uuid}/users", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error listing database users: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+const ListDatabaseClusterDatabases = {
+    name: "list_database_cluster_databases",
+    description: `List all databases for a specific database cluster.`,
+    parameters: digitalocean_openapi_yaml_zod_1.get_Databases_list.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/databases/{database_cluster_uuid}/dbs", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+                _meta: res,
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing database cluster databases: ${error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+const ListDatabaseConnectionPools = {
+    name: "list_database_connection_pools",
+    description: `List all connection pools for a specific database cluster.`,
+    parameters: digitalocean_openapi_yaml_zod_1.get_Databases_list_connectionPools.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/databases/{database_cluster_uuid}/pools", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing database connection pools: ${error}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+const ListDatabaseTopics = {
+    name: "list_database_topics",
+    description: `List all topics for a specific database kafka cluster.`,
+    parameters: digitalocean_openapi_yaml_zod_1.get_Databases_list_kafka_topics.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/databases/{database_cluster_uuid}/topics", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error listing database topics: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+function registerDatabaseTools(server) {
+    server.registerTool(GetDatabaseOptions);
+    server.registerTool(ListDatabasesCluster);
+    server.registerTool(CreateDatabaseCluster);
+    server.registerTool(ListDatabaseFirewallRules);
+    server.registerTool(UpdateDatabaseFirewallRules);
+    server.registerTool(GetDatabaseCluster);
+    server.registerTool(ListDatabaseClusterUsers);
+    server.registerTool(ListDatabaseClusterDatabases);
+    server.registerTool(GetDatabaseClusterCertificate);
+    server.registerTool(ListDatabaseConnectionPools);
+    server.registerTool(ListDatabaseTopics);
+}