DigitalOcean MCP 服务器

⚠️ 存档通知
本仓库已存档。请使用 @digitalocean-labs/mcp-digitalocean

此 MCP 服务器通过标准化工具暴露 DigitalOcean 应用平台的功能，这些工具可以被任何 MCP 客户端使用，包括 Claude Desktop 和 Cursor。它使 AI 助手能够直接管理您的 DigitalOcean 应用程序，无需编写代码或记忆 API 端点。

📚 目录

• 🚀 您能用它做什么？

• 🧰 先决条件

• ⚙️ 设置您的 DigitalOcean MCP 服务器

  • 生成您的 API 令牌
  • 将服务器添加到您的 MCP 客户端
  • Claude Desktop
  • Cursor
  • Windsurf 设置

• 💬 示例提示

• 🛠 可用工具

• 🧯 故障排除

• 🤝 贡献

• 📄 许可证

---

🚀 您能用它做什么？

现在您可以做以下事情：

• 从 GitHub 仓库部署新应用
• 快速重新部署现有应用，并应用最新更改
• 查看日志，重启组件或删除旧环境
• 检查可用区域，并根据支持情况创建应用
• 从零开始构建和部署应用，完全通过您的助手完成

...等等！

---

🧰 先决条件

要使用 DigitalOcean MCP 服务器，您需要：

• Node.js (≥ 12) & npm
• 一个具有 App Platform 权限的 DigitalOcean 个人访问令牌
• 支持的 MCP 客户端：
  • Claude Desktop (v1.9+)
  • Claude Code
  • Cursor
  • Windsurf
• （可选但有用）：GitHub CLI (gh) - 对于克隆仓库、创建项目以及与基于 GitHub 的应用进行操作非常有用。

💡 您不需要安装任何东西——此服务器通过 npx 运行，只需在您的 MCP 客户端中添加一行配置即可。

---

⚙️ 设置您的 DigitalOcean MCP 服务器

1. 生成您的 API 令牌

前往 DigitalOcean 的 API 设置，并创建一个新的具有 App Platform 权限的 个人访问令牌。

2. 将服务器添加到您的 MCP 客户端

将以下 JSON 片段添加到您的客户端 MCP 配置文件中：

{
  "mcpServers": {
    "digitalocean": {
      "command": "npx",
      "args": ["@digitalocean/mcp"],
      "env": {
        "DIGITALOCEAN_API_TOKEN": "YOUR_DO_TOKEN"
      }
    }
  }
}

以下是片段各部分的作用：

• • command: 如何启动服务器 (npx 或完整路径)
• • args: 包名
• • env: 在此处插入您的 DO 令牌

然后按照特定工具的说明进行操作：

Claude Desktop

1. 前往 设置 → 开发者 → 编辑配置
2. 将上述片段添加到 claude_desktop_config.json
3. 将 YOUR_DO_TOKEN 替换为您的令牌
4. 保存并重启 Claude Desktop
5. 您将在可用服务器列表中看到“digitalocean”

在 Claude Desktop 中设置 DigitalOcean MCP 服务器

Cursor

1. 前往 设置 → Cursor 设置 → MCP → 添加新的全局 MCP 服务器
2. Cursor 将打开 ~/.cursor/mcp.json
3. 将上述片段添加到此 json 文件中
4. 将 YOUR_DO_TOKEN 替换为您的令牌
5. 保存，并返回 MCP 设置。
6. 您现在应该在 Cursor 的 MCP 设置中看到“digitalocean”

在 Cursor 中设置 DigitalOcean MCP 服务器

Windsurf 设置

1. 在 Windsurf 中：设置 → Windsurf 设置 → Cascade → MCP → 添加服务器 → 添加自定义服务器
2. Windsurf 将打开 ~/.codeium/windsurf/mcp_config.json
3. 将上述片段添加到此 json 文件中
4. 将 YOUR_DO_TOKEN 替换为您的令牌
5. 保存，并返回 MCP 设置。
6. 您现在应该在 Windsurf 的 MCP 设置中看到“digitalocean”

在 Windsurf 中设置 DigitalOcean MCP 服务器

---

💬 示例提示

一旦配置好，尝试询问您的助手：

“列出我账户上所有活跃的应用”
“从 https://github.com/do-community/do-one-click-deploy-flask 创建一个新应用，并在 NYC3 分配 1GB 内存”
“显示 checkout-service 的日志”
“取消 marketing-site 的当前部署”
“删除旧的 `staging-env` 应用”

助手会发送请求 → MCP 服务器与 DigitalOcean 通信 → 您将获得结构化的结果，准备好采取行动。

---

可用工具

类别	命令
应用	list_apps, create_app, get_app, update_app, delete_app, restart_app
部署	list_deployments, create_deployment, get_deployment, cancel_deployment
日志	retrieve_active_deployment_logs, download_logs
基础设施	list_app_regions, list_instance_sizes
警报	list_app_alerts, update_app_alert_destinations
回滚	validate_app_rollback, rollback_app, commit_app_rollback, revert_app_rollback
指标	get_app_bandwidth_daily_metrics, get_all_app_bandwidth_daily_metrics
验证	validate_app_spec

---

故障排除

服务器未出现在您的客户端中？

• 确保您的 JSON 配置已保存且有效
• 重启您的 MCP 客户端（Claude、Cursor、Windsurf）

令牌不起作用？

• 检查它是否具有 App Platform 访问权限
• 尝试生成一个新的

JSON 错误？

• 不允许尾随逗号
• JSON 中不允许有注释

您还可以通过运行以下命令直接测试服务器：

npx @digitalocean/mcp

---

贡献

我们欢迎您的帮助来改进这个项目！欢迎提交 bug 报告、新功能和文档改进。

1. 分叉此仓库
2. 创建一个分支 (git checkout -b feature/awesome-tool)
3. 打开一个 PR

---

许可证

本项目根据 MIT 许可证授权。