digitalocean/digitalocean-mcp

digitalocean/digitalocean-mcp

Description: DigitalOcean MCP Server for deploying and managing apps on App Platform

Language: TypeScript

Stars: 78

Forks: 12

Open issues: 3

Created: 2025-04-24T23:21:14Z

Pushed: 2025-07-23T01:36:31Z

Default branch: main

Fork: no

Archived: yes

README:

DigitalOcean MCP Server

> ⚠️ ARCHIVE NOTICE > This repository has been archived. Please use [@digitalocean-labs/mcp-digitalocean](https://github.com/digitalocean-labs/mcp-digitalocean/)

This MCP server exposes DigitalOcean App Platform functionality through standardized tools that can be used by any MCP client, including Claude Desktop and Cursor. It enables AI assistants to directly manage your DigitalOcean apps without writing code or memorizing API endpoints.


📚 Table of Contents

• [🚀 What Can You Do With It?](#-what-can-you-do-with-it)
• [🧰 Prerequisites](#-prerequisites)
• [⚙️ Setting up your DigitalOcean MCP Server](#️-setting-up-your-digitalocean-mcp-server)

• [Generate Your API Token](#1-generate-your-api-token)
• [Add the Server to Your MCP Client](#2-add-the-server-to-your-mcp-client)
• [Claude Desktop](#claude-desktop)
• [Cursor](#cursor)
• [Windsurf Setup](#windsurf-setup)

• [💬 Example Prompts](#-example-prompts)
• [🛠 Available Tools](#available-tools)
• [🧯 Troubleshooting](#troubleshooting)
• [🤝 Contributing](#contributing)
• [📄 License](#license)

---

🚀 What Can You Do With It?

You can now do things like:

• Deploy a new app from a GitHub repo
• Quickly redeploy an existing app with the latest changes
• See logs, restart components, or delete old environments
• Check available regions and create apps based on what’s supported
• Build and deploy an app from scratch, entirely through your assistant

...and more!

---

🧰 Prerequisites

To use the DigitalOcean MCP Server, you’ll need:

• Node.js (≥ 12) & npm
• A DigitalOcean Personal Access Token with App Platform scopes
• A supported MCP client:
• Claude Desktop (v1.9+)
• Claude Code
• Cursor
• Windsurf
• (Optional but helpful): GitHub CLI (gh) - useful for cloning repos, creating projects, and working with GitHub-based apps.

> 💡 You do not need to install anything—this server runs via npx, with just a one-line config added to your MCP client.

---

⚙️ Setting up your DigitalOcean MCP Server

1. Generate Your API Token

Head to DigitalOcean’s API settings and create a new Personal Access Token with App Platform permissions.

2. Add the Server to Your MCP Client

Add this JSON snippet to your client’s MCP config file:

{
"mcpServers": {
"digitalocean": {
"command": "npx",
"args": ["@digitalocean/mcp"],
"env": {
"DIGITALOCEAN_API_TOKEN": "YOUR_DO_TOKEN"
}
}
}
}

Here’s what each part of the snippet does:

• - command: how to launch the server (npx or full path)
• - args: the package name
• - env: insert your DO token here

Then follow the instructions for your specific tool:

Claude Desktop

1. Go to Settings → Developer → Edit Config 2. Add the snippet above to claude_desktop_config.json 3. Replace YOUR_DO_TOKEN with your token 4. Save and restart Claude Desktop 5. You'll see “digitalocean” listed as an available server

!Claude Desktop MCP Setup _Setting up DigitalOcean MCP Server in Claude Desktop_

Cursor

1. Go to Settings → Cursor Settings → MCP → Add a new global MCP server 2. Cursor will open ~/.cursor/mcp.json 3. Add the snippet above to this json file 4. Replace YOUR_DO_TOKEN with your token 5. Save, and return to MCP Settings. 6. You should now see “digitalocean” in Cursor’s MCP settings

!Cursor MCP Setup _Setting up DigitalOcean MCP Server in Cursor_

Windsurf Setup

1. In Windsurf: Settings → Windsurf Settings → Cascade → MCP → Add Server → Add custom server 2. Windsurf will open ~/.codeium/windsurf/mcp_config.json 3. Add the snippet above to this json file 4. Replace YOUR_DO_TOKEN with your token 5. Save, and return to MCP Settings. 6. You should now see “digitalocean” in Windsurf's MCP settings

!Windsurf MCP Setup

_Setting up DigitalOcean MCP Server in Windsurf_

---

💬 Example Prompts

Once it’s configured, try asking your assistant:

“List all active apps on my account”
“Create a new app from https://github.com/do-community/do-one-click-deploy-flask with 1GB RAM in NYC3”
“Show logs for checkout-service”
“Cancel the current deployment for marketing-site”
“Delete the old `staging-env` app”

The assistant will send the request → the MCP server talks to DigitalOcean → you get structured results, ready to act on.

---

Available Tools

| Category | Commands | | --------------- | ------------------------------------------------------------------------------------- | | Apps | list_apps, create_app, get_app, update_app, delete_app, restart_app | | Deployments | list_deployments, create_deployment, get_deployment, cancel_deployment | | Logs | retrieve_active_deployment_logs, download_logs | | Infra | list_app_regions, list_instance_sizes | | Alerts | list_app_alerts, update_app_alert_destinations | | Rollbacks | validate_app_rollback, rollback_app, commit_app_rollback, revert_app_rollback | | Metrics | get_app_bandwidth_daily_metrics, get_all_app_bandwidth_daily_metrics | | Validation | validate_app_spec |

---

Troubleshooting

The server doesn’t appear in your client?

• Make sure your JSON config is saved and valid
• Restart your MCP client (Claude, Cursor, Windsurf)

Token not working?

-…