# @digitalocean/mcp 中文文档

规范地址：https://npmcn.com/package/%40digitalocean/mcp/

版本：1\.6\.7
npm 元数据更新时间：2026-11-12T05:27:44.074Z
中文译文更新时间：2026-11-12T09:06:40.645Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40digitalocean/mcp
原文对照：https://npmcn.com/package/%40digitalocean/mcp/?lang=original
项目主页：https://github.com/digitalocean-labs/mcp-digitalocean?tab=readme-ov-file#mcp-digitalocean-integration
源码仓库：https://github.com/digitalocean-labs/mcp-digitalocean

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：154 MB，17 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：0 个
- 首次发布：2025-04-25T21:27:11.550Z
- 最新版本发布：2026-11-12T05:27:43.860Z
- 近 30 天下载量：23866（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：96（近 12 个月 59 个）

## 中文简介

数字海洋MCP 执行,

## 安装

```sh
npm install @digitalocean/mcp
```

也可以使用：`pnpm add @digitalocean/mcp`、`yarn add @digitalocean/mcp`、`bun add @digitalocean/mcp`

## README

# MCP 数字海洋一体化

MCP DigitalOcean集成是一个开源项目,为管理 DigitalOcean 资源以及使用该集成器执行动作提供了全面的接口 [数字海洋 API](https://docs.digitalocean.com/reference/api/)上方为 [前进](https://github.com/digitalocean/godo) 图书馆和图书馆 [MCP框架](https://github.com/mark3labs/mcp-go),该项目暴露出多种简化云基础设施管理的工具.

> **分局:** "利用MCP技术与您的数字海洋账户互动 [可以带来风险](https://www.wiz.io/blog/mcp-security-research-briefing)" (中文(简体) )

* * *

## 认证

托管(远程)的MCP服务器支持两种认证方式:

-   **OAuth 2.0 (建议).** 只要添加服务器 URL - 不 `Authorization` 头曰. 您的客户端打开一个浏览器, 以便在 DigitalOcean 首次使用时签名, 所以没有符号可以创建、 存储或旋转 。 支持的客户端(例如最近的克洛德和Cursor)自动处理,您可以在下面跳过步骤1–2.
-   **API标志.** 对于没有 OAuth 支持的本地安装或客户端,请使用 DigitalOcean [个人访问令牌](https://cloud.digitalocean.com/account/api/tokens) 通过一个 `Authorization: Bearer` 页眉( 远程) 或 `DIGITALOCEAN_API_TOKEN` 环境变量(当地)。 见下文步骤1-2.

* * *

## 安全性: 从不为您的 API 编码 脚本

> **警报:** 不要将您的 DigitalOcean API 令牌直接粘贴到任何配置文件(例如, `claude_desktop_config.json`, (中文(简体) ), `~/.cursor/config.json`, VS 代码设置). 如果您将这些文件承诺给 GitHub, 您的令牌将会被曝光, GitHub 将自动屏蔽或撤销它以保护您的账户 .

安全的方法是 将你的纪念物存放在 **环境变量** 在您的机器上,并从您的配置文件中引用它。 在启动任何客户端安装之前, 请遵循以下操作系统步骤 .

* * *

## 步骤1: 将您的 API 键设置为环境变量

### macOS / Linux 系统

#### 选项A: 将其设置在您的外壳配置中( 建议 )

1.  打开一个终端.
    
2.  确定您使用的外壳 :
    
    ```bash
    echo $SHELL
    ```
    
    -   如果输出 `/bin/zsh` ——编辑 `~/.zshrc`
    -   如果输出 `/bin/bash` ——编辑 `~/.bashrc` 或者说 `~/.bash_profile`
3.  在文本编辑器中打开文件 :
    
    ```bash
    # For zsh (default on macOS Monterey and later)
    nano ~/.zshrc
    
    # For bash
    nano ~/.bashrc
    ```
    
4.  在文件底部添加以下一行:
    
    ```bash
    export DIGITALOCEAN_API_TOKEN="your_actual_token_here"
    ```
    
    替换 `your_actual_token_here` 带着你真正的象征 [数字海洋 API 托肯斯页面](https://cloud.digitalocean.com/account/api/tokens)。 。 。 .
    
5.  保存并退出 :
    
    -   单位 `nano`编辑: `Ctrl + O`,则 `Enter` 用于保存,然后 `Ctrl + X` 离开.
6.  重新装入您的外壳以应用更改 :
    
    ```bash
    source ~/.zshrc    # or source ~/.bashrc
    ```
    
7.  校验其设置正确 :
    
    ```bash
    echo $DIGITALOCEAN_API_TOKEN
    ```
    
    你应该看看你的纪念品印在终端上.
    

#### 备选案文B:使用a `.env` 文件(用于项目级别隔离)

1.  在您的工程根文件夹中,创建 `.env` 文件 :
    
    ```bash
    touch .env
    ```
    
2.  打开并添加:
    
    ```
    DIGITALOCEAN_API_TOKEN=your_actual_token_here
    ```
    
3.  **马上** 添加 `.env` 给您的 `.gitignore` 因此,它从来没有承诺:
    
    ```bash
    echo ".env" >> .gitignore
    ```
    
4.  装入 `.env` 输入当前终端会话:
    
    ```bash
    export $(grep -v '^#' .env | xargs)
    ```
    
5.  校验 :
    
    ```bash
    echo $DIGITALOCEAN_API_TOKEN
    ```
    

> **说明:** 选项B只设置当前终端会话的变量. 每次开通新航站楼都要跑出第四步. 对于永久解决方案,使用选项A.

* * *

### 窗口

#### 备选方案A:将其设定为系统环境变量(建议——在反复重复的情况下持续存在)

1.  打开 **启动菜单** 并查找 **“环境变量”**。 。 。 .
2.  点击 **"编辑系统环境变量"**。 。 。 .
3.  在系统属性对话框中,单击 **"环境变量..."** 按钮.
4.  下 **“用户变量”**,单击 **"新... ..." "New..."**。 。 。 .
5.  填写:
    -   **变量名称 :** `DIGITALOCEAN_API_TOKEN`
    -   **变量值 :** `your_actual_token_here`
6.  点击 **** 用于保存所有对话框.
7.  **重新启动您的终端** (命令即时或Powershell) 更改生效.
8.  在 PowerShell 中验证 :
    
    ```powershell
    echo $env:DIGITALOCEAN_API_TOKEN
    ```
    
    或者在命令提示中 :
    
    ```cmd
    echo %DIGITALOCEAN_API_TOKEN%
    ```
    

#### 备选案文B:将其暂时设为PowerShell(仅本期会议)

```powershell
$env:DIGITALOCEAN_API_TOKEN = "your_actual_token_here"
```

#### 备选案文C:使用a `.env` 在 Windows 上的文件

1.  在您的工程文件夹中创建一个名为 `.env` 包含此内容的( 无扩展) :
    
    ```
    DIGITALOCEAN_API_TOKEN=your_actual_token_here
    ```
    
2.  添加 `.env` 给您的 `.gitignore`数字 :
    
    ```
    .env
    ```
    
3.  要装入PowerShell:
    
    ```powershell
    Get-Content .env | ForEach-Object {
      if ($_ -match "^\s*([^#][^=]*)=(.*)$") {
        [System.Environment]::SetEnvironmentVariable($matches[1].Trim(), $matches[2].Trim(), "Process")
      }
    }
    ```
    
4.  校验 :
    
    ```powershell
    echo $env:DIGITALOCEAN_API_TOKEN
    ```
    

* * *

## 步骤2:获取您的数字海洋 API 脚本

1.  登录您的数字海洋账户 .
2.  导航到 **API 密码** → **键** 在左侧栏中,或直接去: `https://cloud.digitalocean.com/account/api/tokens`
3.  点击 **"Generate New Token" (希腊语)**。 。 。 .
4.  给它一个名字(例如, `mcp-local-dev`),设定过期,并选择所需的范围.
5.  立即复制符文——只显示一次.
6.  使用上面步骤1所述方法之一储存.

* * *

## 安装

### 远程 MCP( 建议)

最容易启动的方法是使用DigitalOcean主机MCP服务. 每个服务都是作为一个独立的MCP服务器通过HTTPS访问而部署的,可以不运行任何本地服务器而连接. 通过在配置中添加多个条目,可以同时连接多个端点.

这些服务器支持 **OAuth 2.0(建议)** 和 API- token 认证 — 见 [认证](https://npmcn.com/package/%40digitalocean/mcp/#readme-authentication)。下面的每个客户部分都显示两个选项.

#### 可用服务

| 服务 | 远程 MCP URL | 说明 |
| --- | --- | --- |
| 应用程序 | [https://apps.mcp.digital ocean.com/mcp (中文(中国大陆) )](https://apps.mcp.digitalocean.com/mcp) | 管理 DigitalOcean App平台应用,包括部署和配置. |
| 账户 | [https://accounts.mcp.digitalocean.com/mcp (中文(简体) )](https://accounts.mcp.digitalocean.com/mcp) | 获取有关您的数字海洋账户、账单、余额、发票和SSH密钥的信息. |
| 数据库 | [https://databases.mcp.digitalocean.com/mcp (中文(简体) )](https://databases.mcp.digitalocean.com/mcp) | 提供、管理和监测管理的数据库集群(Postgres、MySQL、Redis等). |
| 点数 | [https://doks.mcp.digital ocean.com/mcp (中文(简体) )](https://doks.mcp.digitalocean.com/mcp) | 管理 DigitalOcean Kubernetes 集群和节点池. |
| 滴点 | [https://droplets.mcp.digitalocean.com/mcp (中文(中国大陆) )](https://droplets.mcp.digitalocean.com/mcp) | 在 DigitalOcean 上创建,管理,调整大小,快照,并监视滴子(虚拟机). |
| 微维 | [https://microvms.mcp. 数码海洋.com/mcp](https://microvms.mcp.digitalocean.com/mcp) | 创建,列表,获取,暂停,恢复,执行,读取/写入文件,检查点,并删除 DigitalOcean MicroVM. 见 [MicroVM服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/microdroplet/README.md)。 。 。 . |
| 医生 | [https://docr.mcp.digitalocean.com/mcp (中文(中国大陆) )](https://docr.mcp.digitalocean.com/mcp) | 管理数字海洋集装箱登记库、标签、清单和垃圾收集. |
| (原始内容存档于2013-10-21). genai-battchinference | [https://genai-batchinference.mcp.digital ocean.com/mcp (中文(简体) )](https://genai-batchinference.mcp.digitalocean.com/mcp) | 创建,管理,并监控批量推断工作,用于同步批量的AI处理. |
| 信号 | [https://signals.mcp.digital ocean.com/mcp (中文(简体) )](https://signals.mcp.digitalocean.com/mcp) | 调查渐变代理和无服务器推论会话,会段,以及数字海洋信号的同意. |
| 运行时间 | [https://harness-runtime.mcp.digitalocean.com/mcp 互联网档案馆的存檔,存档日期2014-12-21](https://harness-runtime.mcp.digitalocean.com/mcp) | 列出并检查DigitalOcean Harness Runtime的托管代理配置. |
| genai-海关模式 | [https://genai-custom-models.mcp.digital ocean.com/mcp (中文(简体) )](https://genai-custom-models.mcp.digitalocean.com/mcp) | 在DigitalOcean的GenAI平台上导入,列出,更新并删除自定义(bring-自有)模型. |
| 基因推导器 | [https://genai-inferencerouter.mcp.digital ocean.com/mcp (中文(简体) )](https://genai-inferencerouter.mcp.digitalocean.com/mcp) | 创建,列出,获取,并删除GenAI模型路由器. |
| 专门参考 | [https://dedicate-inference.mcp. 数字海洋.com/mcp 互联网档案馆的存檔,存档日期2013-12-21](https://dedicated-inference.mcp.digitalocean.com/mcp) | 管理为 GPU 加速模型服务的专用推论实例 . |
| 推论模型目录 | [https://inference-modelcatalog.mcp.digitalocean.com/mcp 互联网档案馆的存檔,存档日期2013-12-21](https://inference-modelcatalog.mcp.digitalocean.com/mcp) | 浏览 DigitalOcean 推论模型目录,搜索模型,并获得模型卡. |
| 见解 | [https://insights.mcp.digitalocean.com/mcp (中文(中国大陆) )](https://insights.mcp.digitalocean.com/mcp) | 监视您的资源, 端点并提醒您, 当它们缓慢, 不可用, 或者 SSL 证书即将过期 . |
| 市场 | [https://marketplace.mcp.digital ocean.com/mcp 页面存档备份,存于互联网档案馆](https://marketplace.mcp.digitalocean.com/mcp) | 发现并管理"数字海洋"市场应用. |
| 联网 | [https://networking.mcp.digital ocean.com/mcp 互联网档案馆的存檔,存档日期2013-12-21](https://networking.mcp.digitalocean.com/mcp) | 管理域,DNS记录,证书,防火墙,负载平衡器,保留IP,BYOIP前缀,VPC,和CDN. |
| 函数 | [https://documents.mcp.digitalocean.com/mcp (中文(简体) )](https://functions.mcp.digitalocean.com/mcp) | 管理无服务器的函数命名空间,动作,软件包,触发器,以及活化. |
| 空间 | [https://spaces.mcp.digitalocean.com/mcp (中文(中国大陆) )](https://spaces.mcp.digitalocean.com/mcp) | DigitalOcean Spaces 天体存储和Space访问S3兼容存储的密钥. |
| 文档 | [https://docs.mcp.数字海洋.com/mcp](https://docs.mcp.digitalocean.com/mcp) | 搜取"数字海洋"公共文献. 不需要 API 令牌 . |
| 地质评估 | [https://genai-valuation.mcp.digital ocean.com/mcp (中文(中国大陆) )](https://genai-evaluation.mcp.digitalocean.com/mcp) | 在"数字海洋"GenAI平台管理和运行评价工作流程. |
| 无 | [https://nfs.mcp.digitalocean.com/mcp (中文(简体) )](https://nfs.mcp.digitalocean.com/mcp) | 管理 DigitalOcean NFS 文件共享和文件共享快照. |
| 数量 | [https://volums.mcp.digitalocean.com/mcp (中文(简体) )](https://volumes.mcp.digitalocean.com/mcp) | 管理 DigitalOcean 块存储卷和音量快照. |
| 矢量数据库 | [https://vector-databases.mcp.digitalocean.com/mcp (中文(简体) )](https://vector-databases.mcp.digitalocean.com/mcp) | 创建、列出、调整大小、删除和检查管理的Weaviate矢量数据库集群. |

* * *

### 克劳德代码

#### 远程 MCP( 建议)

**备选案文A——OAuth(建议).** 添加服务器为无 `Authorization` 页眉; Claude 提示您在第一次使用时签名 :

```bash
claude mcp add --transport http digitalocean-apps https://apps.mcp.digitalocean.com/mcp
```

**备选案文B——API令牌.** 保证你完成了第一步和你的 `DIGITALOCEAN_API_TOKEN` 设置了环境变量。 然后运行 :

```bash
claude mcp add --transport http digitalocean-apps https://apps.mcp.digitalocean.com/mcp \
  --header "Authorization: Bearer $DIGITALOCEAN_API_TOKEN"
```

> **如何运作:** 这个 `$DIGITALOCEAN_API_TOKEN` 由您运行命令时的外壳扩展 。 实际的象征值被安全地存储在克洛德的配置中——你从不将象征贴入自己的命令.

您可以以同样的方式添加多种服务 :

```bash
claude mcp add --transport http digitalocean-databases https://databases.mcp.digitalocean.com/mcp \
  --header "Authorization: Bearer $DIGITALOCEAN_API_TOKEN"

claude mcp add --transport http digitalocean-droplets https://droplets.mcp.digitalocean.com/mcp \
  --header "Authorization: Bearer $DIGITALOCEAN_API_TOKEN"
```

见 [可用服务](https://npmcn.com/package/%40digitalocean/mcp/#readme-available-services) 区域,用于完整可用的终点列表.

#### 本地安装

```bash
claude mcp add digitalocean-mcp \
  -e DIGITALOCEAN_API_TOKEN=$DIGITALOCEAN_API_TOKEN \
  -- npx @digitalocean/mcp --services apps,databases
```

这将:

-   在默认(局部)范围内添加 MCP 服务器——意味着它只在当前文件夹内可用.
-   注册名称 `digitalocean-mcp`。 。 。 .
-   启用 `apps` 财务报告和审定财务报表 `databases` 服务.
-   通过环境变量将您的 DigitalOcean API 令牌安全传递到服务器 .
-   在您的全局 Claude 配置中存储配置 `~/.claude.json`中,已瞄准当前文件夹.

#### 验证安装

为了确认这一点,增加了:

```bash
claude mcp list
```

#### 检查细节

详细情况:

```bash
claude mcp get digitalocean-mcp
```

#### 删除服务器

要删除它:

```bash
claude mcp remove digitalocean-mcp
```

##### 用户范围

当你在一个项目中测试或仅仅使用服务器时,局部范围是巨大的. 用户范围更好, 如果您想要在任何地方都可以使用 .

如果您想在全球范围提供服务器( 所以你不需要在每一个项目中重新添加), 您可以使用 `user` 范围 :

```bash
claude mcp add -s user digitalocean-mcp-user-scope \
  -e DIGITALOCEAN_API_TOKEN=$DIGITALOCEAN_API_TOKEN \
  -- npx @digitalocean/mcp --services apps,databases
```

这将:

-   在所有文件夹中提供服务器,而不只是您所在的文件夹
-   范围为您的用户账户
-   在您的全球克劳德配置中存储 `~/.claude.json`

要删除它:

```bash
claude mcp remove -s user digitalocean-mcp-user-scope
```

* * *

### 克劳德桌面

#### 远程 MCP( 建议)

**在编辑配置文件之前**,确保 `DIGITALOCEAN_API_TOKEN` 设置在您的外壳配置文件(见步骤1-选项A)。 Claude桌面读取您发射时的外壳配置中的环境变量 .

配置文件位于 :

-   **马可斯:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-   **窗口 :** `%APPDATA%\Claude\claude_desktop_config.json`
-   **林纳:** `~/.config/Claude/claude_desktop_config.json`

**备选案文A——OAuth(建议).** Claude 桌面通过 [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) 桥,它打开一个浏览器供您在 DigitalOcean 首次使用时签名 :

```json
{
  "mcpServers": {
    "digitalocean-apps": {
      "command": "npx",
      "args": ["mcp-remote", "https://apps.mcp.digitalocean.com/mcp"]
    }
  }
}
```

**备选案文B——API令牌.** 将远程 MCP 服务器添加到您的配置文件中 。 引用 env var 使用 `${DIGITALOCEAN_API_TOKEN}` Claude桌面将在运行时替换:

```json
{
  "mcpServers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGITALOCEAN_API_TOKEN}"
      }
    },
    "digitalocean-databases": {
      "url": "https://databases.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}
```

> **重要内容:** 这个 `${DIGITALOCEAN_API_TOKEN}` 语法让 Claude Desktop 从您系统的环境变量读取值 。 您的实际代号从未写入此文件 。 此文件可以安全执行版本控制 .

您可以添加列表中的任何终点 [可用服务](https://npmcn.com/package/%40digitalocean/mcp/#readme-available-services) 节.

#### 本地安装

在您的 `claude_desktop_config.json` 文档。 这个 `env` 块直接将环境变量传递到 MCP 服务器进程——不需要硬编码的令牌 :

```json
{
  "mcpServers": {
    "digitalocean": {
      "command": "npx",
      "args": ["@digitalocean/mcp", "--services", "apps"],
      "env": {
        "DIGITALOCEAN_API_TOKEN": "${DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}
```

> **如何运作:** 这个 `"env"` 在 Claude 桌面配置中将环境变量传递到产入的 MCP 服务器进程。 这个 `${DIGITALOCEAN_API_TOKEN}` 值在运行时从您的系统环境中解析。 您的令牌从未存储在配置文件本身中 .

在保存文件后, **重新启动 Claude 桌面** 以便改变生效.

* * *

### 光标

#### 远程 MCP( 建议)

**在编辑配置文件之前**,确保 `DIGITALOCEAN_API_TOKEN` 设置在您的外壳配置文件(见步骤1-选项A).

Cursor 配置文件位于 :

-   **macOS / Linux :** `~/.cursor/config.json`
-   **窗口 :** `%USERPROFILE%\.cursor\config.json`

**备选案文A——OAuth(建议).** 只添加没有的 URL `headers` 块; 光标提示您在第一次使用时签名 :

```json
{
  "mcpServers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp"
    }
  }
}
```

**备选案文B——API令牌.** 将远程 MCP 服务器添加到您的光标设置文件 :

```json
{
  "mcpServers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGITALOCEAN_API_TOKEN}"
      }
    },
    "digitalocean-databases": {
      "url": "https://databases.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}
```

您可以添加列表中的任何终点 [可用服务](https://npmcn.com/package/%40digitalocean/mcp/#readme-available-services) 节.

#### 本地安装

[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=digitalocean&config=eyJjb21tYW5kIjoibnB4IEBkaWdpdGFsb2NlYW4vbWNwIC0tc2VydmljZXMgYXBwcyIsImVudiI6eyJESUdJVEFMT0NFQU5fQVBJX1RPS0VOIjoiWU9VUl9BUElfVE9LRU4ifX0%3D)

将以下内容添加到位于您的光标设置文件 `~/.cursor/config.json`数字 :

```json
{
  "mcpServers": {
    "digitalocean": {
      "command": "npx",
      "args": ["@digitalocean/mcp", "--services", "apps"],
      "env": {
        "DIGITALOCEAN_API_TOKEN": "${DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}
```

> **如何运作:** 光标解析 `${DIGITALOCEAN_API_TOKEN}` 在启动 MCP 服务器时从您的系统环境变量中选择 。 在启动 Cursor 之前, 请在您的外壳配置中确定变量 .

##### 验证安装

1.  打开光标并打开命令调色板(`Shift + ⌘ + P` 麦克或 `Ctrl + Shift + P` 在 Windows/Linux 上进行)
2.  在命令调色板搜索栏中搜索"MCP"
3.  选择“ 查看: 打开 MCP 设置"
4.  从左侧边栏选择“ 工具与集成 ”
5.  您应该看到“ 数字海洋” 列表于可用的 MCP 服务器
6.  点击“ N 启用的工具” (N 是当前启用的工具数量)

##### 调试

要检查 MCP 服务器日志和调试问题 :

1.  打开命令调色板( M)`⌘+Shift+P` 麦克或 `Ctrl+Shift+P` 在 Windows/Linux 上进行)
2.  键入"开发者:切换开发者工具"并按 Enter
3.  导航到 Console 选项卡以查看 MCP 服务器日志
4.  您可以在与 MCP 服务器交互时找到与 MCP 相关的日志

##### 测试连接

在Cursor的聊天中,尝试询问:"列出我所有的数字海洋应用程序"——这应该会触发MCP服务器,如果配置得当的话可以获取你的应用程序. 如果您遇到401个错误或认证相关的错误, 请确认 `DIGITALOCEAN_API_TOKEN` 变量通过运行正确设置 `echo $DIGITALOCEAN_API_TOKEN` 在你的终端.

* * *

### VS 代码

#### 远程 MCP( 建议)

**在编辑配置文件之前**,确保 `DIGITALOCEAN_API_TOKEN` 设置在您的外壳配置文件(见步骤1-选项A).

VS 代码 MCP 配置文件位于 `.vscode/mcp.json` 在工作空间根中。 如果不存在, 则创建此文件 .

**备选案文A——OAuth(建议).** 只添加没有的 URL `headers` 块; VS 代码提示您在第一次使用时签名 :

```json
{
  "servers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp"
    }
  }
}
```

**备选案文B——API令牌.** 使用 VS 代码添加远程 MCP 服务器 `inputs` 特性以安全方式提示符号 :

```json
{
  "inputs": [
    {
      "id": "digitalocean-token",
      "type": "promptString",
      "description": "DigitalOcean API Token",
      "password": true
    }
  ],
  "servers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:digitalocean-token}"
      }
    },
    "digitalocean-databases": {
      "url": "https://databases.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:digitalocean-token}"
      }
    }
  }
}
```

> **如何进行VS 代码输入工作 :** 这个 `inputs` 块定义一个命名的输入 (`digitalocean-token`VS代码将 **引导您安全进入** 第一次使用服务器。 您的令牌被存储在 VS 代码的秘密存储中—— 从未被写入纯文本的磁盘. 这个 `"password": true` 旗帜确保在输入时被遮住。 这个配置文件完全可以安全地承诺给 GitHub .

或者,如果您喜欢直接使用系统环境变量:

```json
{
  "inputs": [],
  "servers": {
    "digitalocean-apps": {
      "url": "https://apps.mcp.digitalocean.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}
```

> **说明:** VS 代码使用 `${env:VARIABLE_NAME}` 从系统环境变量读取的语法.

#### 本地安装

在您的 `.vscode/mcp.json` 文档。 使用 VS 代码 `inputs` 用于避免硬编码符号的特性 :

```json
{
  "inputs": [
    {
      "id": "digitalocean-token",
      "type": "promptString",
      "description": "DigitalOcean API Token",
      "password": true
    }
  ],
  "servers": {
    "mcpDigitalOcean": {
      "command": "npx",
      "args": ["@digitalocean/mcp", "--services", "apps"],
      "env": {
        "DIGITALOCEAN_API_TOKEN": "${input:digitalocean-token}"
      }
    }
  }
}
```

或者,直接使用系统环境变量:

```json
{
  "inputs": [],
  "servers": {
    "mcpDigitalOcean": {
      "command": "npx",
      "args": ["@digitalocean/mcp", "--services", "apps"],
      "env": {
        "DIGITALOCEAN_API_TOKEN": "${env:DIGITALOCEAN_API_TOKEN}"
      }
    }
  }
}
```

##### 验证安装

1.  打开 VS 代码和打开命令调色板(`Shift + ⌘ + P` 麦克或 `Ctrl + Shift + P` 在 Windows/Linux 上进行)
2.  在命令调色板搜索栏中搜索"MCP"
3.  选择“ MCP: 列表服务器”
4.  验证“ mcpDigitalOcean” 是否出现在配置的服务器列表中

##### 查看可用的工具

查看 MCP 服务器中可用的工具 :

1.  打开命令调色板( M)`⌘+Shift+P` 麦克或 `Ctrl+Shift+P` 在 Windows/Linux 上进行)
2.  在聊天框中选择“ 代理” 模式
3.  点击右边的“配置工具”并检查数字海洋相关工具 `MCP Server: mcpDigitalocean`。您应当能够列出可用的工具,例如 `app-create`, (中文(简体) ), `app-list`, (中文(简体) ), `app-delete`等 (中文(简体) ).

##### 调试

要排除 MCP 连接的故障 :

1.  打开命令调色板( M)`⌘+Shift+P` 麦克或 `Ctrl+Shift+P` 在 Windows/Linux 上进行)
2.  键入"开发者:切换开发者工具"并按 Enter
3.  导航到 Console 选项卡以查看 MCP 服务器日志
4.  检查连接状态和错误消息

如果您遇到401个错误或认证相关的错误, 请确认 `DIGITALOCEAN_API_TOKEN` 通过运行设置变量 `echo $DIGITALOCEAN_API_TOKEN` 在启动 VS 代码前, 在您的终端.

* * *

## 步骤3:保护你的托肯——核对清单

在将任何代码推进到 GitHub 之前, 验证以下内容 :

-   [ ]  `.env` 文件( 如果使用) 列于 `.gitignore`
-   [ ] 没有配置文件包含类似原始符号字符串 `dop_v1_...`
-   [ ] 配置文件使用 `${DIGITALOCEAN_API_TOKEN}`, (中文(简体) ), `${env:DIGITALOCEAN_API_TOKEN}`,或 `${input:...}` 语法
-   [ ] 你跑出来了 `git diff` 或者说 `git status` 证实没有秘密
-   [ ] 你从未有过任何迹象——如果你有, [立即旋转](https://cloud.digitalocean.com/account/api/tokens) 并废除旧的

> **如果你的标志已经承诺:** 转到 [数字海洋 API 托肯斯页面](https://cloud.digitalocean.com/account/api/tokens),删除已损坏的符号,并生成一个新的符号。 GitHub的秘密扫描会自动检测并标出被曝光的标志.

* * *

## 当地安装的先决条件

如果使用本地安装方法(不是远程MCP),则需要:

-   节点.js(v18或后期)
-   国家预防机制(v8或以后)

您可以在 [https://nodejs.org/en/下行负荷](https://nodejs.org/en/download)

校验您的安装 :

```bash
node --version
npm --version
```

### 快速测试

为校验本地的 MCP 服务器工作正确, 您可以直接从命令行测试( 确保 `DIGITALOCEAN_API_TOKEN` 将首先设定在您的环境中 :

```bash
npx @digitalocean/mcp --services apps
```

* * *

## 配置

### 本地安装配置

当使用本地安装时,您使用 `--services` 标记以指定要启用的服务。 强烈建议只允许您需要的服务降低上下文大小并改进准确性. 见下文所支持的服务清单.

```bash
npx @digitalocean/mcp --services apps,droplets
```

## 文档

每个服务都提供详细的README,描述所有可用的工具,资源,参数,以及实例查询. 完整文件见以下档案:

-   [应用服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/apps/README.md)
-   [投递服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/droplet/README.md)
-   [账户服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/account/README.md)
-   [网络服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/networking/README.md)
-   [数据库服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/dbaas/README.md)
-   [透视服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/insights/README.md)
-   [空间处](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/spaces/README.md)
-   [采购处](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/marketplace/README.md)
-   [职能处](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/functions/README.md)
-   [DOKS 服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/doks/README.md)
-   [DOCR 服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/docr/README.md)
-   [专门推论处](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/dedicated-inference/README.md)
-   [推论模型目录服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/inference-modelcatalog/README.md)
-   [医生服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/docs/README.md)
-   [评价](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/genai/README.md)
-   [GenAI 批量参考服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/genai-batchinference/README.md)
-   [信号服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/signals/README.md)
-   [运行时服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/harness-runtime/README.md)
-   [MicroVM服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/microdroplet/README.md)
-   [GenAI 自定义模型服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/genai-custom-models/README.md)
-   [GenAI 推论路由器](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/genai-inferencerouter/README.md)
-   [NFS 服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/nfs/README.md)
-   [卷口服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/volumes/README.md)
-   [矢量数据库服务](https://npmcn.com/package/%40digitalocean/mcp/pkg/registry/vectordb/README.md)

## 示例工具

-   按名称搜索目录模型 : `inference-model-catalog-search`
-   打开一个目录模型的完整元数据 : `inference-model-catalog-get-card`
-   从 GitHub repo 中部署应用程序 : `create-app-from-spec`
-   调整滴数大小 : `droplet-resize`
-   在 MicroVM 中运行命令 : `microvm-exec`
-   将一个文件写入一个 microVM : `microvm-file-write`
-   添加一个新的 SSH 密钥 : `key-create`
-   创建新域 : `domain-create`
-   启用液滴上的备份 : `droplet-enable-backups`
-   刷新 CDN 缓存 : `cdn-flush-cache`
-   创建 VPC 对等连接 : `vpc-peering-create`
-   删除 VPC 对等连接 : `vpc-peering-delete`
-   搜索数字海洋文档 : `docs-search`
-   获取服务快速启动指南 : `docs-get-quickstart`
-   查找错误的排除文件 : `docs-troubleshoot`
-   与文件页面相关的发现页面 : `docs-get-related`

## 捐款

欢迎捐款! 如果遇到任何问题或有改进想法,请随意打开一个问题或提交拉动请求.

1.  叉出宝库.
2.  为您的特性或错误修正创建新分支 .
3.  提交一个拉动请求, 并清楚描述您的更改 .

## 许可证

这个项目根据麻省理工学院的许可证获得许可。 见 [自由主义](https://npmcn.com/package/%40digitalocean/mcp/LICENSE) 详细文件.

## 常见问题

### @digitalocean/mcp 是什么？

数字海洋MCP 执行,

### 如何安装 @digitalocean/mcp？

在项目目录运行 npm install @digitalocean/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp，可以用 npx mcp 直接运行。

### @digitalocean/mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/digitalocean\_\_mcp 是否存在。

### @digitalocean/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @digitalocean/mcp 可以商用吗？

@digitalocean/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @digitalocean/mcp 的下载量有多少？

根据 npm 官方下载统计，@digitalocean/mcp 在 2026/10/12 – 2026/11/10 这 30 天内被下载 23,866 次，日均约 796 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @digitalocean/mcp 还在维护吗？

最新版本 1\.6\.7 发布于 2026/11/12（今天）；至今共发布 96 个版本，其中过去 12 个月发布了 59 个；首次发布于 2025/04/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。