You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
@@ -4,30 +4,54 @@ MCP DigitalOcean Integration is an open-source project that provides a comprehen
4
4
5
5
> **DISCLAIMER:** "Use of MCP technology to interact with your DigitalOcean account [can come with risks](https://www.wiz.io/blog/mcp-security-research-briefing)"
6
6
7
-
## Prerequisites
7
+
## Installation
8
8
9
-
- Node.js (v18 or later)
10
-
- NPM (v8 or later)
9
+
### Remote MCP (Recommended)
11
10
12
-
You can find installation guides at [https://nodejs.org/en/download](https://nodejs.org/en/download)
11
+
The easiest way to get started is to use DigitalOcean's hosted MCP services. Each service is deployed as a standalone MCP server accessible via HTTPS, allowing you to connect without running any local server. You can connect to multiple endpoints simultaneously by adding multiple entries to your configuration.
| droplets |https://droplets.mcp.digitalocean.com/mcp| Create, manage, resize, snapshot, and monitor droplets (virtual machines) on DigitalOcean. |
22
+
| insights |https://insights.mcp.digitalocean.com/mcp| Monitors your resources, endpoints and alert you when they're slow, unavailable, or SSL certificates are expiring. |
23
+
| marketplace |https://marketplace.mcp.digitalocean.com/mcp| Discover and manage DigitalOcean Marketplace applications. |
24
+
| networking |https://networking.mcp.digitalocean.com/mcp| Manage domains, DNS records, certificates, firewalls, load balancers, reserved IPs, BYOIP Prefixes, VPCs, and CDNs. |
25
+
| spaces |https://spaces.mcp.digitalocean.com/mcp| DigitalOcean Spaces object storage and Spaces access keys for S3-compatible storage. |
26
+
27
+
---
28
+
29
+
### Claude Code
30
+
31
+
#### Remote MCP (Recommended)
32
+
33
+
To add a remote DigitalOcean MCP server to [Claude Code](https://www.anthropic.com/claude-code), run the following command in your terminal:
14
34
15
-
Verify your installation:
16
35
```bash
17
-
node --version
18
-
npm --version
36
+
claude mcp add --transport http digitalocean-apps https://apps.mcp.digitalocean.com/mcp \
37
+
--header "Authorization: Bearer YOUR_API_TOKEN"
19
38
```
20
39
21
-
## Quick Test
40
+
Replace `YOUR_API_TOKEN` with your actual DigitalOcean API token.
41
+
42
+
You can add multiple services by running the command for each endpoint:
22
43
23
-
To verify the MCP server works correctly, you can test it directly from the command line:
24
44
```bash
25
-
npx @digitalocean/mcp --services apps
45
+
claude mcp add --transport http digitalocean-databases https://databases.mcp.digitalocean.com/mcp \
46
+
--header "Authorization: Bearer YOUR_API_TOKEN"
47
+
48
+
claude mcp add --transport http digitalocean-droplets https://droplets.mcp.digitalocean.com/mcp \
49
+
--header "Authorization: Bearer YOUR_API_TOKEN"
26
50
```
27
51
28
-
## Installation
52
+
See the [Available Services](#available-services) section for the complete list of available endpoints.
29
53
30
-
###Claude Code
54
+
#### Local Installation
31
55
32
56
To add the DigitalOcean MCP server to [Claude Code](https://www.anthropic.com/claude-code), run the following command in your terminal:
33
57
@@ -62,25 +86,7 @@ To remove it:
62
86
claude mcp remove digitalocean-mcp
63
87
```
64
88
65
-
### Claude Desktop
66
-
67
-
Alternatively, add the following to your claude_desktop_config.json file.
68
-
69
-
```json
70
-
{
71
-
"mcpServers": {
72
-
"digitalocean": {
73
-
"command": "npx",
74
-
"args": ["@digitalocean/mcp", "--services apps"],
75
-
"env": {
76
-
"DIGITALOCEAN_API_TOKEN": "YOUR_API_TOKEN"
77
-
}
78
-
}
79
-
}
80
-
}
81
-
```
82
-
83
-
### Claude Code (User Scope)
89
+
##### User Scope
84
90
85
91
Local scope is great when you're testing or only using the server in one project. User scope is better if you want it available everywhere.
86
92
@@ -102,8 +108,84 @@ To remove it:
102
108
claude mcp remove -s user digitalocean-mcp-user-scope
103
109
```
104
110
111
+
---
112
+
113
+
### Claude Desktop
114
+
115
+
#### Remote MCP (Recommended)
116
+
117
+
Add the remote MCP servers to your `claude_desktop_config.json` file:
Add the following to your Cursor settings file located at `~/.cursor/config.json`:
@@ -122,7 +204,7 @@ Add the following to your Cursor settings file located at `~/.cursor/config.json
122
204
}
123
205
```
124
206
125
-
#### Verify Installation in Cursor
207
+
#####Verify Installation
126
208
127
209
1. Open Cursor and open Command Pallet ( `Shift + ⌘ + P` on Mac or `Ctrl+ Shift + P` on Windows/Linux )
128
210
2. Search for "MCP" in the command pallet search bar
@@ -131,20 +213,52 @@ Add the following to your Cursor settings file located at `~/.cursor/config.json
131
213
5. You should see "digitalocean" listed under Available MCP Servers
132
214
6. Click on "N tools enabled" (N is the number of tools currently enabled).
133
215
134
-
#### Debugging in Cursor
216
+
#####Debugging
135
217
136
218
To check MCP server logs and debug issues:
137
219
1. Open the Command Palette (⌘+Shift+P on Mac or Ctrl+Shift+P on Windows/Linux)
138
220
2. Type "Developer: Toggle Developer Tools" and press Enter
139
221
3. Navigate to the Console tab to view MCP server logs
140
222
4. You'll find MCP related logs as you interact with the MCP server
141
223
142
-
#### Testing the Connection
224
+
#####Testing the Connection
143
225
144
226
In Cursor's chat, try asking: "List all my DigitalOcean apps" - this should trigger the MCP server to fetch your apps if properly configured. If you are getting an 401 error or authentication related errors, it is likely due to misconfiguring your access token.
145
227
228
+
---
229
+
146
230
### VS Code
147
231
232
+
#### Remote MCP (Recommended)
233
+
234
+
Add the remote MCP servers to your VS Code MCP configuration file:
You can add any of the endpoints listed in the [Available Services](#available-services) section.
259
+
260
+
#### Local Installation
261
+
148
262
Add the following to your VS Code MCP configuration file:
149
263
150
264
```json
@@ -168,21 +282,21 @@ Add the following to your VS Code MCP configuration file:
168
282
}
169
283
```
170
284
171
-
#### Verify Installation in VS Code
285
+
#####Verify Installation
172
286
173
-
1. Open Cursor and open Command Pallet ( `Shift + ⌘ + P` on Mac or `Ctrl+ Shift + P` on Windows/Linux )
287
+
1. Open VS Code and open Command Pallet ( `Shift + ⌘ + P` on Mac or `Ctrl+ Shift + P` on Windows/Linux )
174
288
2. Search for "MCP" in the command pallet search bar
175
289
3. Select "MCP: List Servers"
176
290
4. Verify that "mcpDigitalOcean" appears in the list of configured servers
177
291
178
-
#### Viewing Available Tools
292
+
#####Viewing Available Tools
179
293
180
294
To see what tools are available from the MCP server:
181
295
1. Open the Command Palette (⌘+Shift+P on Mac or Ctrl+Shift+P on Windows/Linux)
182
296
2. Select "Agent" mode in the chatbox,
183
297
3. Click "Configure tools" on the right, and check for digitalocean related tools under `MCP Server: mcpDigitalocean`. You should be able to list available tools like `app-create`, `app-list`, `app-delete`, etc.
184
298
185
-
#### Debugging in VS Code
299
+
#####Debugging
186
300
187
301
To troubleshoot MCP connections:
188
302
1. Open the Command Palette (⌘+Shift+P on Mac or Ctrl+Shift+P on Windows/Linux)
@@ -192,30 +306,41 @@ To troubleshoot MCP connections:
192
306
193
307
If you are getting an 401 error or authentication related errors, it is likely due to misconfiguring your access token.
194
308
195
-
## Configuration
309
+
---
310
+
311
+
## Prerequisites for Local Installation
312
+
313
+
If you're using the local installation method (not Remote MCP), you'll need:
314
+
315
+
- Node.js (v18 or later)
316
+
- NPM (v8 or later)
317
+
318
+
You can find installation guides at [https://nodejs.org/en/download](https://nodejs.org/en/download)
319
+
320
+
Verify your installation:
321
+
```bash
322
+
node --version
323
+
npm --version
324
+
```
196
325
197
-
To configure tools, you use the `--services` flag to specify which service you want to enable. It is highly recommended to only
198
-
enable the services you need to reduce context size and improve accuracy. See list of supported services below.
326
+
### Quick Test
199
327
328
+
To verify the local MCP server works correctly, you can test it directly from the command line:
200
329
```bash
201
-
npx @digitalocean/mcp --services apps,droplets
330
+
npx @digitalocean/mcp --services apps
202
331
```
203
332
204
-
## Supported Services
333
+
---
334
+
335
+
## Configuration
336
+
337
+
### Local Installation Configuration
205
338
206
-
The MCP DigitalOcean Integration supports the following services, allowing users to manage their DigitalOcean infrastructure effectively
339
+
When using the local installation, you use the `--services` flag to specify which service you want to enable. It is highly recommended to only enable the services you need to reduce context size and improve accuracy. See list of supported services below.
0 commit comments