MCP 数字海洋一体化
MCP DigitalOcean集成是一个开源项目,为管理 DigitalOcean 资源以及使用该集成器执行动作提供了全面的接口 数字海洋 API上方为 前进 图书馆和图书馆 MCP框架,该项目暴露出多种简化云基础设施管理的工具.
分局: "利用MCP技术与您的数字海洋账户互动 可以带来风险" (中文(简体) )
认证
托管(远程)的MCP服务器支持两种认证方式:
- OAuth 2.0 (建议). 只要添加服务器 URL - 不
Authorization头曰. 您的客户端打开一个浏览器, 以便在 DigitalOcean 首次使用时签名, 所以没有符号可以创建、 存储或旋转 。 支持的客户端(例如最近的克洛德和Cursor)自动处理,您可以在下面跳过步骤1–2. - API标志. 对于没有 OAuth 支持的本地安装或客户端,请使用 DigitalOcean 个人访问令牌 通过一个
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: 将其设置在您的外壳配置中( 建议 )
-
打开一个终端.
-
确定您使用的外壳 :
echo $SHELL- 如果输出
/bin/zsh——编辑~/.zshrc - 如果输出
/bin/bash——编辑~/.bashrc或者说~/.bash_profile
- 如果输出
-
在文本编辑器中打开文件 :
# For zsh (default on macOS Monterey and later) nano ~/.zshrc # For bash nano ~/.bashrc -
在文件底部添加以下一行:
export DIGITALOCEAN_API_TOKEN="your_actual_token_here"替换
your_actual_token_here带着你真正的象征 数字海洋 API 托肯斯页面。 。 。 . -
保存并退出 :
- 单位
nano编辑:Ctrl + O,则Enter用于保存,然后Ctrl + X离开.
- 单位
-
重新装入您的外壳以应用更改 :
source ~/.zshrc # or source ~/.bashrc -
校验其设置正确 :
echo $DIGITALOCEAN_API_TOKEN你应该看看你的纪念品印在终端上.
备选案文B:使用a .env 文件(用于项目级别隔离)
-
在您的工程根文件夹中,创建
.env文件 :touch .env -
打开并添加:
DIGITALOCEAN_API_TOKEN=your_actual_token_here -
马上 添加
.env给您的.gitignore因此,它从来没有承诺:echo ".env" >> .gitignore -
装入
.env输入当前终端会话:export $(grep -v '^#' .env | xargs) -
校验 :
echo $DIGITALOCEAN_API_TOKEN
说明: 选项B只设置当前终端会话的变量. 每次开通新航站楼都要跑出第四步. 对于永久解决方案,使用选项A.
窗口
备选方案A:将其设定为系统环境变量(建议——在反复重复的情况下持续存在)
- 打开 启动菜单 并查找 “环境变量”。 。 。 .
- 点击 "编辑系统环境变量"。 。 。 .
- 在系统属性对话框中,单击 "环境变量..." 按钮.
- 下 “用户变量”,单击 "新... ..." "New..."。 。 。 .
- 填写:
- 变量名称 :
DIGITALOCEAN_API_TOKEN - 变量值 :
your_actual_token_here
- 变量名称 :
- 点击 用于保存所有对话框.
- 重新启动您的终端 (命令即时或Powershell) 更改生效.
- 在 PowerShell 中验证 :
或者在命令提示中 :echo $env:DIGITALOCEAN_API_TOKENecho %DIGITALOCEAN_API_TOKEN%
备选案文B:将其暂时设为PowerShell(仅本期会议)
$env:DIGITALOCEAN_API_TOKEN = "your_actual_token_here"
备选案文C:使用a .env 在 Windows 上的文件
-
在您的工程文件夹中创建一个名为
.env包含此内容的( 无扩展) :DIGITALOCEAN_API_TOKEN=your_actual_token_here -
添加
.env给您的.gitignore数字 :.env -
要装入PowerShell:
Get-Content .env | ForEach-Object { if ($_ -match "^\s*([^#][^=]*)=(.*)$") { [System.Environment]::SetEnvironmentVariable($matches[1].Trim(), $matches[2].Trim(), "Process") } } -
校验 :
echo $env:DIGITALOCEAN_API_TOKEN
步骤2:获取您的数字海洋 API 脚本
- 登录您的数字海洋账户 .
- 导航到 API 密码 → 键 在左侧栏中,或直接去:
https://cloud.digitalocean.com/account/api/tokens - 点击 "Generate New Token" (希腊语)。 。 。 .
- 给它一个名字(例如,
mcp-local-dev),设定过期,并选择所需的范围. - 立即复制符文——只显示一次.
- 使用上面步骤1所述方法之一储存.
安装
远程 MCP( 建议)
最容易启动的方法是使用DigitalOcean主机MCP服务. 每个服务都是作为一个独立的MCP服务器通过HTTPS访问而部署的,可以不运行任何本地服务器而连接. 通过在配置中添加多个条目,可以同时连接多个端点.
这些服务器支持 OAuth 2.0(建议) 和 API- token 认证 — 见 认证。下面的每个客户部分都显示两个选项.
可用服务
克劳德代码
远程 MCP( 建议)
备选案文A——OAuth(建议). 添加服务器为无 Authorization 页眉; Claude 提示您在第一次使用时签名 :
claude mcp add --transport http digitalocean-apps https://apps.mcp.digitalocean.com/mcp
备选案文B——API令牌. 保证你完成了第一步和你的 DIGITALOCEAN_API_TOKEN 设置了环境变量。 然后运行 :
claude mcp add --transport http digitalocean-apps https://apps.mcp.digitalocean.com/mcp \
--header "Authorization: Bearer $DIGITALOCEAN_API_TOKEN"
如何运作: 这个
$DIGITALOCEAN_API_TOKEN由您运行命令时的外壳扩展 。 实际的象征值被安全地存储在克洛德的配置中——你从不将象征贴入自己的命令.
您可以以同样的方式添加多种服务 :
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"
见 可用服务 区域,用于完整可用的终点列表.
本地安装
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中,已瞄准当前文件夹.
验证安装
为了确认这一点,增加了:
claude mcp list
检查细节
详细情况:
claude mcp get digitalocean-mcp
删除服务器
要删除它:
claude mcp remove digitalocean-mcp
用户范围
当你在一个项目中测试或仅仅使用服务器时,局部范围是巨大的. 用户范围更好, 如果您想要在任何地方都可以使用 .
如果您想在全球范围提供服务器( 所以你不需要在每一个项目中重新添加), 您可以使用 user 范围 :
claude mcp add -s user digitalocean-mcp-user-scope \
-e DIGITALOCEAN_API_TOKEN=$DIGITALOCEAN_API_TOKEN \
-- npx @digitalocean/mcp --services apps,databases
这将:
- 在所有文件夹中提供服务器,而不只是您所在的文件夹
- 范围为您的用户账户
- 在您的全球克劳德配置中存储
~/.claude.json
要删除它:
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 桥,它打开一个浏览器供您在 DigitalOcean 首次使用时签名 :
{
"mcpServers": {
"digitalocean-apps": {
"command": "npx",
"args": ["mcp-remote", "https://apps.mcp.digitalocean.com/mcp"]
}
}
}
备选案文B——API令牌. 将远程 MCP 服务器添加到您的配置文件中 。 引用 env var 使用 ${DIGITALOCEAN_API_TOKEN} Claude桌面将在运行时替换:
{
"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 从您系统的环境变量读取值 。 您的实际代号从未写入此文件 。 此文件可以安全执行版本控制 .
您可以添加列表中的任何终点 可用服务 节.
本地安装
在您的 claude_desktop_config.json 文档。 这个 env 块直接将环境变量传递到 MCP 服务器进程——不需要硬编码的令牌 :
{
"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 块; 光标提示您在第一次使用时签名 :
{
"mcpServers": {
"digitalocean-apps": {
"url": "https://apps.mcp.digitalocean.com/mcp"
}
}
}
备选案文B——API令牌. 将远程 MCP 服务器添加到您的光标设置文件 :
{
"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}"
}
}
}
}
您可以添加列表中的任何终点 可用服务 节.
本地安装
将以下内容添加到位于您的光标设置文件 ~/.cursor/config.json数字 :
{
"mcpServers": {
"digitalocean": {
"command": "npx",
"args": ["@digitalocean/mcp", "--services", "apps"],
"env": {
"DIGITALOCEAN_API_TOKEN": "${DIGITALOCEAN_API_TOKEN}"
}
}
}
}
如何运作: 光标解析
${DIGITALOCEAN_API_TOKEN}在启动 MCP 服务器时从您的系统环境变量中选择 。 在启动 Cursor 之前, 请在您的外壳配置中确定变量 .
验证安装
- 打开光标并打开命令调色板(
Shift + ⌘ + P麦克或Ctrl + Shift + P在 Windows/Linux 上进行) - 在命令调色板搜索栏中搜索"MCP"
- 选择“ 查看: 打开 MCP 设置"
- 从左侧边栏选择“ 工具与集成 ”
- 您应该看到“ 数字海洋” 列表于可用的 MCP 服务器
- 点击“ N 启用的工具” (N 是当前启用的工具数量)
调试
要检查 MCP 服务器日志和调试问题 :
- 打开命令调色板( M)
⌘+Shift+P麦克或Ctrl+Shift+P在 Windows/Linux 上进行) - 键入"开发者:切换开发者工具"并按 Enter
- 导航到 Console 选项卡以查看 MCP 服务器日志
- 您可以在与 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 代码提示您在第一次使用时签名 :
{
"servers": {
"digitalocean-apps": {
"url": "https://apps.mcp.digitalocean.com/mcp"
}
}
}
备选案文B——API令牌. 使用 VS 代码添加远程 MCP 服务器 inputs 特性以安全方式提示符号 :
{
"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-tokenVS代码将 引导您安全进入 第一次使用服务器。 您的令牌被存储在 VS 代码的秘密存储中—— 从未被写入纯文本的磁盘. 这个"password": true旗帜确保在输入时被遮住。 这个配置文件完全可以安全地承诺给 GitHub .
或者,如果您喜欢直接使用系统环境变量:
{
"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 用于避免硬编码符号的特性 :
{
"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}"
}
}
}
}
或者,直接使用系统环境变量:
{
"inputs": [],
"servers": {
"mcpDigitalOcean": {
"command": "npx",
"args": ["@digitalocean/mcp", "--services", "apps"],
"env": {
"DIGITALOCEAN_API_TOKEN": "${env:DIGITALOCEAN_API_TOKEN}"
}
}
}
}
验证安装
- 打开 VS 代码和打开命令调色板(
Shift + ⌘ + P麦克或Ctrl + Shift + P在 Windows/Linux 上进行) - 在命令调色板搜索栏中搜索"MCP"
- 选择“ MCP: 列表服务器”
- 验证“ mcpDigitalOcean” 是否出现在配置的服务器列表中
查看可用的工具
查看 MCP 服务器中可用的工具 :
- 打开命令调色板( M)
⌘+Shift+P麦克或Ctrl+Shift+P在 Windows/Linux 上进行) - 在聊天框中选择“ 代理” 模式
- 点击右边的“配置工具”并检查数字海洋相关工具
MCP Server: mcpDigitalocean。您应当能够列出可用的工具,例如app-create, (中文(简体) ),app-list, (中文(简体) ),app-delete等 (中文(简体) ).
调试
要排除 MCP 连接的故障 :
- 打开命令调色板( M)
⌘+Shift+P麦克或Ctrl+Shift+P在 Windows/Linux 上进行) - 键入"开发者:切换开发者工具"并按 Enter
- 导航到 Console 选项卡以查看 MCP 服务器日志
- 检查连接状态和错误消息
如果您遇到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证实没有秘密 - 你从未有过任何迹象——如果你有, 立即旋转 并废除旧的
如果你的标志已经承诺: 转到 数字海洋 API 托肯斯页面,删除已损坏的符号,并生成一个新的符号。 GitHub的秘密扫描会自动检测并标出被曝光的标志.
当地安装的先决条件
如果使用本地安装方法(不是远程MCP),则需要:
- 节点.js(v18或后期)
- 国家预防机制(v8或以后)
您可以在 https://nodejs.org/en/下行负荷
校验您的安装 :
node --version
npm --version
快速测试
为校验本地的 MCP 服务器工作正确, 您可以直接从命令行测试( 确保 DIGITALOCEAN_API_TOKEN 将首先设定在您的环境中 :
npx @digitalocean/mcp --services apps
配置
本地安装配置
当使用本地安装时,您使用 --services 标记以指定要启用的服务。 强烈建议只允许您需要的服务降低上下文大小并改进准确性. 见下文所支持的服务清单.
npx @digitalocean/mcp --services apps,droplets
文档
每个服务都提供详细的README,描述所有可用的工具,资源,参数,以及实例查询. 完整文件见以下档案:
- 应用服务
- 投递服务
- 账户服务
- 网络服务
- 数据库服务
- 透视服务
- 空间处
- 采购处
- 职能处
- DOKS 服务
- DOCR 服务
- 专门推论处
- 推论模型目录服务
- 医生服务
- 评价
- GenAI 批量参考服务
- 信号服务
- 运行时服务
- MicroVM服务
- GenAI 自定义模型服务
- GenAI 推论路由器
- NFS 服务
- 卷口服务
- 矢量数据库服务
示例工具
- 按名称搜索目录模型 :
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
捐款
欢迎捐款! 如果遇到任何问题或有改进想法,请随意打开一个问题或提交拉动请求.
- 叉出宝库.
- 为您的特性或错误修正创建新分支 .
- 提交一个拉动请求, 并清楚描述您的更改 .
许可证
这个项目根据麻省理工学院的许可证获得许可。 见 自由主义 详细文件.