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 Personal Access Token
• 対応している 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 にアクセスし、新しい Personal Access Token を作成します。

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. このリポジトリをフォークします
2. ブランチを作成します（git checkout -b feature/my-feature）
3. 変更を加えます
4. テストを実行します（uv run pytest）
5. PR を作成します

---

ライセンス

このプロジェクトは MIT License のもとでライセンスされています。