# mcp-server-digitalocean [Health: Active] **Category:** ☁️ Cloud Platforms **Repository:** https://github.com/truecallerabreham/mcp-server-digitalocean **GitHub Stars:** 0 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/mcp-server-digitalocean ## Description MCP server for DigitalOcean — manage Droplets, databases, domains, and more ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `uvx` (confidence: high): ```json "mcpServers": { "mcp-server-digitalocean": { "command": "uvx", "args": ["mcp-server-digitalocean"] } } ``` ## Documentation & README # DigitalOcean MCP Server [![PyPI version](https://img.shields.io/pypi/v/mcp-server-digitalocean.svg)](https://pypi.org/project/mcp-server-digitalocean/) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT) [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) A [Model Context Protocol](https://modelcontextprotocol.io) server for [DigitalOcean](https://www.digitalocean.com/) cloud infrastructure. Manage Droplets, databases, domains, and more — all through your AI assistant. ## What Can You Do With It? - **Manage Droplets** — list, create, get details, and delete Droplets - **Query Databases** — list and inspect managed database clusters - **Handle Domains** — list, create, and delete domain records - **Explore Infrastructure** — browse available regions and Droplet sizes with pricing - **Check Account** — view account info and usage limits ## Table of Contents - [Prerequisites](#prerequisites) - [Installation](#installation) - [Setup](#setup) - [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](#windsurf) - [Claude Code](#claude-code) - [Available Tools](#available-tools) - [Example Prompts](#example-prompts) - [Development](#development) - [Troubleshooting](#troubleshooting) - [Contributing](#contributing) - [License](#license) --- ## Prerequisites - **Python** >= 3.10 - A [DigitalOcean Personal Access Token](https://cloud.digitalocean.com/account/api/tokens) - A supported MCP client: - [Claude Desktop](https://claude.ai/download) - [Claude Code](https://docs.anthropic.com/en/docs/claude-code/overview) - [Cursor](https://docs.cursor.com/context/model-context-protocol) - [Windsurf](https://windsurf.com) --- ## Installation ### Using uv (recommended) ```bash uv tool install mcp-server-digitalocean ``` ### Using pip ```bash pip install mcp-server-digitalocean ``` --- ## Setup ### 1. Generate Your API Token Go to [DigitalOcean API Tokens](https://cloud.digitalocean.com/account/api/tokens) and create a new **Personal Access Token**. ### 2. Add the Server to Your MCP Client Add this JSON snippet to your client's MCP config file: ```json { "mcpServers": { "digitalocean": { "command": "uvx", "args": ["mcp-server-digitalocean"], "env": { "DIGITALOCEAN_TOKEN": "YOUR_DO_TOKEN" } } } } ``` Then follow the instructions for your specific client: ### 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 ### 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 ### Windsurf 1. Go to **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 ### Claude Code 1. Run in your terminal: ```bash claude mcp add digitalocean -- uvx mcp-server-digitalocean ``` 2. Set the environment variable: ```bash export DIGITALOCEAN_TOKEN="your-token-here" ``` --- ## Available Tools | Category | Tools | |----------|-------| | **Account** | `get_account_info` | | **Droplets** | `list_droplets`, `get_droplet`, `create_droplet`, `delete_droplet` | | **Databases** | `list_database_clusters`, `get_database_cluster` | | **Domains** | `list_domains`, `create_domain`, `delete_domain` | | **Infrastructure** | `list_regions`, `list_sizes` | --- ## Example Prompts Once configured, try asking your assistant: ``` "List all my Droplets" "Create a new 1GB Droplet in NYC1 running Ubuntu 24.04" "Show me all available regions" "List my database clusters" "Delete droplet 42" "What Droplet sizes are available and how much do they cost?" ``` --- ## Development ```bash # Clone the repo git clone https://github.com/truecallerabreham/mcp-server-digitalocean.git cd mcp-server-digitalocean # Install dependencies uv sync # Run tests uv run pytest # Run linter uv run ruff check src/ tests/ # Type check uv run pyright ``` --- ## Troubleshooting ### The server doesn't appear in your client? - Make sure your JSON config is saved and valid (no trailing commas) - Restart your MCP client (Claude, Cursor, Windsurf) - Check that `uvx` is in your PATH ### Token not working? - Verify the token has the correct scopes - Try generating a fresh one at [DigitalOcean API Tokens](https://cloud.digitalocean.com/account/api/tokens) ### Still having issues? Test the server directly: ```bash DIGITALOCEAN_TOKEN="your-token" uvx mcp-server-digitalocean ``` --- ## Contributing Contributions are welcome! Bug reports, new features, and docs improvements are all appreciated. 1. Fork this repo 2. Create a branch (`git checkout -b feature/my-feature`) 3. Make your changes 4. Run tests (`uv run pytest`) 5. Open a PR --- ## License This project is licensed under the [MIT License](https://github.com/truecallerabreham/mcp-server-digitalocean/blob/HEAD/LICENSE).