@digitalocean/mcp 0.0.7

package/build/tools/app.js

@@ -0,0 +1,631 @@
+"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 = {
+    name: "list_apps",
+    description: `
+    List all apps on your account. Information about the current active
+    deployment as well as any in progress ones will also be included for
+    each app.
+    `,
+    parameters: digitalocean_openapi_yaml_zod_1.get_Apps_list.parameters.shape,
+    cb: async (params, extra) => {
+        const { client } = (0, api_1.createClient)(extra);
+        const res = await client.get("/v2/apps", {
+            query: params.query,
+        });
+        const apps = res.apps ?? [];
+        if (apps.length === 0) {
+            return {
+                content: [{ type: "text", text: "No apps found" }],
+                isError: true,
+            };
+        }
+        const content = [];
+        apps.forEach((app) => {
+            content.push({
+                type: "text",
+                text: `App ID: ${app.id}\nName: ${app.spec.name}\nRegion: ${app.spec.region}\n`,
+            });
+        });
+        return {
+            content,
+            _meta: res,
+        };
+    },
+};
+exports.CreateApp = {
+    name: "create_app",
+    description: `
+    Create a new app by submitting an app specification. For documentation
+    on app specifications ("AppSpec" objects), please refer to [the product
+    documentation](https://docs.digitalocean.com/products/app-platform/reference/app-spec/).
+  `,
+    parameters: digitalocean_openapi_yaml_zod_1.post_Apps_create.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.post("/v2/apps", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res.app, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error creating app: ${error}` }],
+                isError: true,
+            };
+        }
+    },
+};
+exports.GetApp = {
+    name: "get_app",
+    description: "Get an app by ID",
+    parameters: digitalocean_openapi_yaml_zod_1.get_Apps_get.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get(`/v2/apps/{id}`, {
+                query: {},
+                path: params.path,
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(res.app, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error getting app: ${error}` }],
+            };
+        }
+    },
+};
+exports.UpdateApp = {
+    name: "update_app",
+    description: `
+    Update an existing app by submitting a new app specification. For
+    documentation on app specifications ("AppSpec" objects), please refer to
+    [the product documentation](https://docs.digitalocean.com/products/app-platform/reference/app-spec/).
+  `,
+    parameters: digitalocean_openapi_yaml_zod_1.put_Apps_update.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.put(`/v2/apps/{id}`, params);
+            const app = res.app;
+            return {
+                content: [{ type: "text", text: JSON.stringify(app, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error updating app: ${error}` }],
+                isError: true,
+            };
+        }
+    },
+};
+exports.DeleteApp = {
+    name: "delete_app",
+    description: "Delete an app by ID",
+    parameters: digitalocean_openapi_yaml_zod_1.delete_Apps_delete.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.delete(`/v2/apps/{id}`, params);
+            return {
+                content: [{ type: "text", text: "Add successfully deleted" }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error deleting app: ${error}` }],
+                isError: true,
+            };
+        }
+    },
+};
+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()
+        .describe("The ID of the deployment. If not provided, the active deployment will be used.")
+        .optional(),
+    type: zod_1.z.enum(["BUILD", "DEPLOY", "RUN", "RUN_RESTARTED"]),
+    app_id: zod_1.z.string().describe("The ID of the app."),
+});
+exports.GetDeploymentLogsUrl = {
+    name: "get_deployment_logs_url",
+    description: `
+    Get the URL of the logs for a deployment. Before fetching the logs, you need to
+    get the URL of the logs. 
+  `,
+    parameters: GetDeploymentLogsUrlSchema.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            let content = [];
+            if (params.deployment_id) {
+                const res = await client.get(`/v2/apps/{app_id}/deployments/{deployment_id}/logs`, {
+                    query: {
+                        type: params.type,
+                    },
+                    path: {
+                        app_id: params.app_id,
+                        deployment_id: params.deployment_id,
+                    },
+                });
+                content.push({
+                    type: "text",
+                    text: JSON.stringify(res, null, 2),
+                });
+            }
+            else {
+                const res = await client.get(`/v2/apps/{app_id}/logs`, {
+                    query: {
+                        type: params.type,
+                    },
+                    path: {
+                        app_id: params.app_id,
+                    },
+                });
+                content.push({
+                    type: "text",
+                    text: JSON.stringify(res, null, 2),
+                });
+            }
+            return {
+                content,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error getting logs: ${error}` }],
+            };
+        }
+    },
+};
+const DownloadLogsSchema = zod_1.z.object({
+    url: zod_1.z.string().describe("The URL to the bucket containing the logs"),
+});
+exports.DownloadLogs = {
+    name: "download_logs",
+    description: `
+    Give the URL of the logs, download the logs and return them as a string.
+  `,
+    parameters: DownloadLogsSchema.shape,
+    cb: async (params, extra) => {
+        try {
+            const res = await fetch(params.url);
+            const text = await res.text();
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error getting logs: ${error}` }],
+                isError: true,
+            };
+        }
+    },
+};
+exports.ListDeployments = {
+    name: "list_deployments",
+    description: "List all deployments for an app",
+    parameters: digitalocean_openapi_yaml_zod_1.get_Apps_list_deployments.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get(`/v2/apps/{app_id}/deployments`, params);
+            const deployments = res.deployments ?? [];
+            const content = [];
+            deployments.forEach((deployment) => {
+                content.push({
+                    type: "text",
+                    text: `Deployment ID: ${deployment.id}\nStatus: ${deployment.phase}\nCreated At: ${deployment.created_at}\nUpdated At: ${deployment.updated_at}\n    `,
+                });
+            });
+            content.push({
+                type: "text",
+                text: `${JSON.stringify(res.links, null, 2)}`,
+            });
+            return {
+                content,
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error listing deployments: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+exports.CreateDeployment = {
+    name: "create_deployment",
+    description: "Create a new deployment for an app",
+    parameters: digitalocean_openapi_yaml_zod_1.post_Apps_create_deployment.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.post(`/v2/apps/{app_id}/deployments`, params);
+            const deployment = res.deployment;
+            return {
+                content: [{ type: "text", text: JSON.stringify(deployment) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error creating deployment: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+exports.GetDeployment = {
+    name: "get_deployment",
+    description: "Get a deployment by ID",
+    parameters: digitalocean_openapi_yaml_zod_1.get_Apps_get_deployment.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get(`/v2/apps/{app_id}/deployments/{deployment_id}`, params);
+            const deployment = res.deployment;
+            return {
+                content: [{ type: "text", text: JSON.stringify(deployment) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error getting deployment: ${error}` }],
+                isError: true,
+            };
+        }
+    },
+};
+exports.CancelDeployment = {
+    name: "cancel_deployment",
+    description: "Cancel a deployment by ID",
+    parameters: digitalocean_openapi_yaml_zod_1.post_Apps_cancel_deployment.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.post(`/v2/apps/{app_id}/deployments/{deployment_id}/cancel`, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error canceling deployment: ${error}` },
+                ],
+            };
+        }
+    },
+};
+exports.ListInstanceSizes = {
+    name: "list_instance_sizes",
+    description: "List all instance sizes for `service`, `worker`, and `job` components supported by App Platform.",
+    parameters: undefined,
+    cb: async (extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/apps/tiers/instance_sizes");
+            const instanceSizes = res.instance_sizes ?? [];
+            const content = [];
+            instanceSizes.forEach((instanceSize) => {
+                content.push({
+                    type: "text",
+                    text: `${JSON.stringify(instanceSize, null, 2)}`,
+                });
+            });
+            return {
+                content,
+                _meta: {
+                    instanceSizes,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error listing instance sizes: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+exports.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,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get(`/v2/apps/tiers/instance_sizes/{slug}`, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res.instance_size) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error getting instance size: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+exports.ListRegions = {
+    name: "list_app_regions",
+    description: "List all regions supported by App Platform.",
+    cb: async (extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get("/v2/apps/regions");
+            const regions = res.regions ?? [];
+            const content = [];
+            regions.forEach((region) => {
+                content.push({
+                    type: "text",
+                    text: `Region: ${region.label}
+            Slug: ${region.slug}
+            Continent: ${region.continent}
+            Default: ${region.default ? "Yes" : "No"}
+            Disabled: ${region.disabled ? "Yes" : "No"}
+            `,
+                });
+            });
+            return {
+                content,
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error listing regions: ${error}` }],
+                isError: true,
+            };
+        }
+    },
+};
+exports.ValidateAppSpec = {
+    name: "validate_app_spec",
+    description: `
+    Propose and validate a spec for a new or existing app. The request returns some
+    information about the proposed app, including app cost and upgrade cost.
+    If an existing app ID is specified, the app spec is treated as a
+    proposed update to the existing app.
+  `,
+    parameters: digitalocean_openapi_yaml_zod_1.post_Apps_validate_appSpec.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.post("/v2/apps/propose", params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error validating app spec: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+exports.ListAppAlerts = {
+    name: "list_app_alerts",
+    description: `
+    List alerts associated to the app and any components. This includes
+    configuration information about the alerts including emails, slack
+    webhooks, and triggering events or conditions.
+  `,
+    parameters: digitalocean_openapi_yaml_zod_1.get_Apps_list_alerts.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.get(`/v2/apps/{app_id}/alerts`, params);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(res, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error listing app alerts: ${error}` }],
+                isError: true,
+            };
+        }
+    },
+};
+exports.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,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.post(`/v2/apps/{app_id}/alerts/{alert_id}/destinations`, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error updating alert destinations: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+exports.RollbackApp = {
+    name: "rollback_app",
+    description: `
+    Rollback an app to a previous deployment. A new deployment will be
+    created to perform the rollback.
+    The app will be pinned to the rollback deployment preventing any new
+    deployments from being created, either manually or through Auto Deploy on Push webhooks. 
+    To resume deployments, the rollback must beeither committed or reverted.
+    It is recommended to use the Validate App Rollback endpoint to double check if the rollback is valid and if there are any warnings.
+  `,
+    parameters: digitalocean_openapi_yaml_zod_1.post_Apps_create_rollback.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.post(`/v2/apps/{app_id}/rollback`, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error rolling back app: ${error}` }],
+                isError: true,
+            };
+        }
+    },
+};
+exports.ValidateAppRollback = {
+    name: "validate_app_rollback",
+    description: `
+  Check whether an app can be rolled back to a specific deployment. This
+  endpoint can also be used to check if there are any warnings or validation conditions that will
+  cause the rollback to proceed under un-ideal circumstances. For example, if a component must be rebuilt
+  as part of the rollback causing it to take longer than usual.
+  `,
+    parameters: digitalocean_openapi_yaml_zod_1.post_Apps_validate_rollback.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.post(`/v2/apps/{app_id}/rollback/validate`, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error validating app rollback: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+exports.CommitAppRollback = {
+    name: "commit_app_rollback",
+    description: `
+  Commit an app rollback. This action permanently applies the rollback and
+  unpins the app to resume new deployments.
+  `,
+    parameters: digitalocean_openapi_yaml_zod_1.post_Apps_commit_rollback.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            await client.post(`/v2/apps/{app_id}/rollback/commit`, params);
+            return {
+                content: [
+                    { type: "text", text: "App rollback committed successfully." },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error committing app rollback: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+exports.RevertAppRollback = {
+    name: "revert_app_rollback",
+    description: `
+  Revert an app rollback. This action reverts the active rollback by
+  creating a new deployment from the latest app spec prior to the 
+  rollback and unpins the app to resume new deployments.
+  `,
+    parameters: digitalocean_openapi_yaml_zod_1.post_Apps_revert_rollback.parameters.shape,
+    cb: async (params, extra) => {
+        try {
+            const { client } = (0, api_1.createClient)(extra);
+            const res = await client.post(`/v2/apps/{app_id}/rollback/revert`, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(res, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    { type: "text", text: `Error reverting app rollback: ${error}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+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);
+}

package/build/version.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIB_VERSION = void 0;
+// This file is generated. Do not modify.
+exports.LIB_VERSION = "0.0.7";

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@digitalocean/mcp",
+  "version": "0.0.7",
+  "description": "DigitalOcean MCP",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/digitalocean/digitalocean-mcp"
+  },
+  "author": "DigitalOcean",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "mcp": "build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "prebuild": "node -p \"'// This file is generated. Do not modify.\\nexport const LIB_VERSION = ' + JSON.stringify(require('./package.json').version) + ';'\" > src/version.ts",
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start:stdio": "node build/index.js",
+    "generate:schema": "npx typed-openapi src/specs/digitalocean-openapi.yaml -r zod"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.9.0",
+    "dotenv": "^16.5.0",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.14.0",
+    "js-yaml": "^4.1.0",
+    "typed-openapi": "^0.10.1",
+    "typescript": "^5.8.3"
+  }
+}