@digitalocean/mcp 1.0.3 → 1.0.5

package/README.md

@@ -14,9 +14,74 @@ Prerequisites:
 #### Local Installation
 
 ```bash
-npx @digitalocean/mcp --services apps,droplets --log-level debug
+npx @digitalocean/mcp --services apps 
+```
+---
+
+#### Using with Claude Code
+
+To add the DigitalOcean MCP server to [Claude Code](https://www.anthropic.com/claude-code), run the following command in your terminal:
+
+```bash
+claude mcp add digitalocean-mcp \
+  -e DIGITALOCEAN_API_TOKEN=YOUR_DO_API_TOKEN \
+  -- npx @digitalocean/mcp --services apps,databases
+```
+
+This will:
+
+* Add the MCP server under the **default (local)** scope — meaning it's only available inside the current folder.
+* Register it with the name `digitalocean-mcp`.
+* Enable the `apps` and `databases` services.
+* Pass your DigitalOcean API token securely to the server.
+* Store the configuration in your global Claude config at `~/.claude.json`, scoped to the current folder.
+
+To confirm it's been added:
+
+```bash
+claude mcp list
+```
+
+To inspect details:
+
+```bash
+claude mcp get digitalocean-mcp
+```
+
+To remove it:
+
+```bash
+claude mcp remove digitalocean-mcp
+```
+
+---
+
+### Want to use it everywhere?
+**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.
+
+If you’d like to make the server available **globally** (so you don’t have to re-add it in each project), you can use the `user` scope:
+
+```bash
+claude mcp add -s user digitalocean-mcp-user-scope \
+  -e DIGITALOCEAN_API_TOKEN=YOUR_DO_API_TOKEN \
+  -- npx @digitalocean/mcp --services apps,databases
 ```
 
+This will:
+
+* Make the server available in **all folders**, not just the one you’re in
+* Scope it to **your user account**
+* Store it in your global Claude config at `~/.claude.json`
+
+To remove it:
+
+```bash
+claude mcp remove -s user digitalocean-mcp-user-scope
+```
+
+---
+
 #### Using Cursor IDE
 
 [![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=digitalocean&config=eyJjb21tYW5kIjoibnB4IEBkaWdpdGFsb2NlYW4vbWNwIC0tc2VydmljZXMgYXBwcyIsImVudiI6eyJESUdJVEFMT0NFQU5fQVBJX1RPS0VOIjoiWU9VUl9ET19UT0tFTiJ9fQ%3D%3D)
@@ -57,21 +122,30 @@ npx @digitalocean/mcp --services apps,droplets --log-level debug
 }
 ```
 
+## Configuring Tools
+
+To configure tools, 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.
+
+```bash
+npx @digitalocean/mcp --services apps,droplets
+```
+
 ## Supported Services
 
 The MCP DigitalOcean Integration supports the following services, allowing users to manage their DigitalOcean infrastructure effectively
 
 | **Service**     | **Description**                                                                                                    |
 |-----------------|--------------------------------------------------------------------------------------------------------------------|
-| **Apps**        | Manage DigitalOcean App Platform applications, including deployments and configurations.                           |
-| **Droplets**    | Create, manage, resize, snapshot, and monitor droplets (virtual machines) on DigitalOcean.                         |
-| **Account**     | Get information about your DigitalOcean account, billing, balance, invoices, and SSH keys.                         |
-| **Networking**  | Manage domains, DNS records, certificates, firewalls, reserved IPs, VPCs, CDNs, and Partner Network attachments.   |
-| **Insights**    | Monitors your resources, endpoints and alert you when they're slow, unavailable, or SSL certificates are expiring. |
-| **Spaces**      | DigitalOcean Spaces object storage and Spaces access keys for S3-compatible storage.                               |
-| **Databases**   | Provision, manage, and monitor managed database clusters (Postgres, MySQL, Redis, etc.).                           |
-| **Marketplace** | Discover and manage DigitalOcean Marketplace applications.                                                         |
-| **DOKS**        | Manage DigitalOcean Kubernetes clusters and node pools.                                                            |                                                   |
+| **apps**        | Manage DigitalOcean App Platform applications, including deployments and configurations.                           |
+| **droplets**    | Create, manage, resize, snapshot, and monitor droplets (virtual machines) on DigitalOcean.                         |
+| **accounts**    | Get information about your DigitalOcean account, billing, balance, invoices, and SSH keys.                         |
+| **networking**  | Manage domains, DNS records, certificates, firewalls, reserved IPs, VPCs, and CDNs.                                |
+| **insights**    | Monitors your resources, endpoints and alert you when they're slow, unavailable, or SSL certificates are expiring. |
+| **spaces**      | DigitalOcean Spaces object storage and Spaces access keys for S3-compatible storage.                               |
+| **databases**   | Provision, manage, and monitor managed database clusters (Postgres, MySQL, Redis, etc.).                           |
+| **marketplace** | Discover and manage DigitalOcean Marketplace applications.                                                         |
+| **doks**        | Manage DigitalOcean Kubernetes clusters and node pools.                                                            |                                                   |
 ---
 ### Service Documentation
 
@@ -92,28 +166,17 @@ See the following files for full documentation:
 
 ### Example Tool Usage
 
-- Deploy an app from a GitHub repo: `digitalocean-create-app-from-spec`
-- Resize a droplet: `digitalocean-droplet-resize`
-- Add a new SSH key: `digitalocean-key-create`
-- Create a new domain: `digitalocean-domain-create`
-- Enable backups on a droplet: `digitalocean-droplet-enable-backups`
-- Flush a CDN cache: `digitalocean-cdn-flush-cache`
-- Create a VPC peering connection: `digitalocean-vpc-peering-create`
-- Delete a VPC peering connection: `digitalocean-vpc-peering-delete`
+- Deploy an app from a GitHub repo: `create-app-from-spec`
+- Resize a droplet: `droplet-resize`
+- Add a new SSH key: `key-create`
+- Create a new domain: `domain-create`
+- Enable backups on a droplet: `droplet-enable-backups`
+- Flush a CDN cache: `cdn-flush-cache`
+- Create a VPC peering connection: `vpc-peering-create`
+- Delete a VPC peering connection: `vpc-peering-delete`
 
 ---
 
-
-## Configuring Tools
-
-To configure tools, 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.
-
-```bash
-npx @digitalocean/mcp --services apps,droplets
-```
-
----
 ## Contributing
 
 Contributions are welcome! If you encounter any issues or have ideas for improvements, feel free to open an issue or submit a pull request.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitalocean/mcp",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "DigitalOcean MCP Implementation,",
   "author": "DigitalOcean",
   "homepage": "https://github.com/digitalocean-labs/mcp-digitalocean?tab=readme-ov-file#mcp-digitalocean-integration",