mcp-server-digitalocean

DigitalOcean MCP 服务

一个用于 DigitalOcean 云基础设施的 Model Context Protocol 服务。通过 AI 助手管理 Droplet、数据库、域名等资源。

可以用它做什么？

• 管理 Droplet — 列出、创建、查看详情和删除 Droplet
• 查询数据库 — 列出并检查托管数据库集群
• 管理域名 — 列出、创建和删除域名记录
• 探索基础设施 — 浏览可用区域和 Droplet 规格及其价格
• 查看账户 — 查看账户信息和使用限额

目录

• 前提条件
• 安装
• 设置
  • 生成 API 令牌
  • 将服务添加到 MCP 客户端
    • Claude Desktop
    • Cursor
    • Windsurf
    • Claude Code
• 可用工具
• 示例提示词
• 开发
• 故障排除
• 贡献
• 许可证

---

前提条件

• Python >= 3.10
• DigitalOcean 个人访问令牌
• 受支持的 MCP 客户端：
  • Claude Desktop
  • Claude Code
  • Cursor
  • Windsurf

---

安装

使用 uv（推荐）

uv tool install mcp-server-digitalocean

使用 pip

pip install mcp-server-digitalocean

---

设置

1. 生成 API 令牌

前往 DigitalOcean API Tokens，创建一个新的个人访问令牌。

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

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

{
  "mcpServers": {
    "digitalocean": {
      "command": "uvx",
      "args": ["mcp-server-digitalocean"],
      "env": {
        "DIGITALOCEAN_TOKEN": "YOUR_DO_TOKEN"
      }
    }
  }
}

然后按照对应客户端的说明操作：

Claude Desktop

1. 前往 Settings > Developer > Edit Config
2. 将上面的代码片段添加到 claude_desktop_config.json
3. 将 YOUR_DO_TOKEN 替换为你的令牌
4. 保存并重启 Claude Desktop
5. 你会看到 "digitalocean" 列为可用服务

Cursor

1. 前往 Settings > Cursor Settings > MCP > Add a new global MCP server
2. Cursor 将打开 ~/.cursor/mcp.json
3. 将上面的代码片段添加到此 JSON 文件
4. 将 YOUR_DO_TOKEN 替换为你的令牌
5. 保存并返回 MCP Settings

Windsurf

1. 前往 Settings > Windsurf Settings > Cascade > MCP > Add Server > Add custom server
2. Windsurf 将打开 ~/.codeium/windsurf/mcp_config.json
3. 将上面的代码片段添加到此 JSON 文件
4. 将 YOUR_DO_TOKEN 替换为你的令牌
5. 保存并返回 MCP Settings

Claude Code

1. 在终端中运行：

claude mcp add digitalocean -- uvx mcp-server-digitalocean

2. 设置环境变量：

export DIGITALOCEAN_TOKEN="your-token-here"

---

可用工具

类别	工具
账户	get_account_info
Droplet	list_droplets、get_droplet、create_droplet、delete_droplet
数据库	list_database_clusters、get_database_cluster
域名	list_domains、create_domain、delete_domain
基础设施	list_regions、list_sizes

---

示例提示词

配置完成后，可以尝试向助手提问：

"List all my Droplets"
"Create a new 1GB Droplet in NYC1 running Ubuntu 24.04"
"Show me all available regions"
"List my database clusters"
"Delete droplet 42"
"What Droplet sizes are available and how much do they cost?"

---

开发

# Clone the repo
git clone https://github.com/truecallerabreham/mcp-server-digitalocean.git
cd mcp-server-digitalocean

# Install dependencies
uv sync

# Run tests
uv run pytest

# Run linter
uv run ruff check src/ tests/

# Type check
uv run pyright

---

故障排除

服务没有显示在客户端中？

• 确认 JSON 配置已保存且有效（没有尾随逗号）
• 重启 MCP 客户端（Claude、Cursor、Windsurf）
• 确认 uvx 位于 PATH 中

令牌无法使用？

• 确认令牌具有正确的权限范围
• 尝试在 DigitalOcean API Tokens 生成新的令牌

仍然遇到问题？

直接测试服务：

DIGITALOCEAN_TOKEN="your-token" uvx mcp-server-digitalocean

---

贡献

欢迎贡献！我们欢迎提交错误报告、新功能和文档改进。

1. Fork 此仓库
2. 创建分支（git checkout -b feature/my-feature）
3. 进行修改
4. 运行测试（uv run pytest）
5. 提交 PR

---

许可证

本项目采用 MIT License 许可。