MCP Weather & DigitalOcean

MCP DigitalOcean

DigitalOcean App Platform で静的ウェブサイトをデプロイおよび管理するための Model Context Protocol（MCP）サーバーです。

プロジェクト構成

src/
├── index.ts              # Main entry point
├── shared/               # Shared utilities
│   └── api.ts            # Shared API utilities
├── digitalocean/         # DigitalOcean MCP server
│   ├── api.ts            # DigitalOcean API functions
│   ├── server.ts         # DigitalOcean MCP server configuration
│   └── types.ts          # DigitalOcean API types
└── template/             # Template for new MCP servers
    ├── api.ts            # Template API functions
    ├── server.ts         # Template MCP server configuration
    └── types.ts          # Template API types
tests/                    # Test scripts and files

利用可能な MCP サーバー

DigitalOcean サーバー

DigitalOcean MCP サーバーは、DigitalOcean の API を使用して、DigitalOcean App Platform 上の静的ウェブサイトをデプロイおよび管理するツールを提供します。

API トークンの取り扱い

DigitalOcean MCP サーバーは、以下の場所を順番に確認して API トークンを自動的に探します。

1. ツール呼び出し時のパラメーター
2. 環境変数：DO_API_TOKEN または DIGITALOCEAN_API_TOKEN
3. トークンのみを含む ~/.dotoken ファイル
4. プロジェクトルートにある DO_API_TOKEN=your_token を記述した .env ファイル
5. トークンのみを含む ~/.config/digitalocean/token ファイル

つまり、トークンを一度設定すれば、コマンドを実行するたびに指定する必要はありません。

ツール：

• deploy-static-site：DigitalOcean App Platform に静的ウェブサイトをデプロイします

  • 必須パラメーター：
    • app_name：アプリ名
    • repo：GitHub リポジトリ（username/repo）
  • オプションのパラメーター：
    • token：DigitalOcean API トークン（環境変数または設定ファイルに保存されている場合は省略可能）
    • region：リージョンコード（例：nyc、sfo） - デフォルト："nyc"
    • branch：デプロイするブランチ - デフォルト："main"
    • source_dir：ソースコードを含むリポジトリ内のディレクトリ - デフォルト："/"
    • build_command：ビルドコマンド（必要な場合）
    • output_dir：ビルド出力ファイルが保存されるディレクトリ
    • deploy_on_push：git push 時に自動デプロイするかどうか - デフォルト：true
    • environment_slug：ランタイム環境 - デフォルト："html"
    • custom_domain：カスタムドメイン（任意）

• get-app-info：DigitalOcean App Platform のアプリに関する情報を取得します

  • 必須パラメーター：
    • app_id：アプリ ID
  • オプションのパラメーター：
    • token：DigitalOcean API トークン（環境変数または設定ファイルに保存されている場合は省略可能）

• get-deployment-status：特定のデプロイのステータスを取得します

  • 必須パラメーター：
    • app_id：アプリ ID
    • deployment_id：デプロイ ID
  • オプションのパラメーター：
    • token：DigitalOcean API トークン（環境変数または設定ファイルに保存されている場合は省略可能）

• list-deployments：アプリのすべてのデプロイを一覧表示します

  • 必須パラメーター：
    • app_id：アプリ ID
  • オプションのパラメーター：
    • token：DigitalOcean API トークン（環境変数または設定ファイルに保存されている場合は省略可能）

• create-deployment：新しいデプロイを作成します（アプリを再デプロイします）

  • 必須パラメーター：
    • app_id：アプリ ID
  • オプションのパラメーター：
    • token：DigitalOcean API トークン（環境変数または設定ファイルに保存されている場合は省略可能）
    • force_build：キャッシュを使用せずに強制的に再ビルドするかどうか - デフォルト：false

• get-deployment-logs：デプロイのログを取得します

  • 必須パラメーター：
    • app_id：アプリ ID
    • deployment_id：デプロイ ID
  • オプションのパラメーター：
    • token：DigitalOcean API トークン（環境変数または設定ファイルに保存されている場合は省略可能）

• delete-app：DigitalOcean App Platform からアプリを削除します

  • 必須パラメーター：
    • app_id：アプリ ID
  • オプションのパラメーター：
    • token：DigitalOcean API トークン（環境変数または設定ファイルに保存されている場合は省略可能）

新しい MCP サーバーの追加

新しい MCP サーバーを追加するには：

1. template ディレクトリをコピーし、サーバー名に変更します
2. 型、API 関数、サーバー設定を更新します
3. メインの index.ts ファイルにサーバーを追加します

ビルドと実行

# Install dependencies
npm install

# Build the project
npm run build

# Run the DigitalOcean MCP server
node build/index.js

テスト

プロジェクトには、tests/ ディレクトリにいくつかのテストスクリプトが含まれています。

• test-simple.mjs：MCP サーバーに JSON-RPC リクエストを送信するシンプルなテストスクリプト
• test-api.mjs：DigitalOcean API を直接テストするスクリプト
• test-mcp.mjs：MCP サーバーのより包括的なテスト
• test-deploy.mjs：deploy-static-site ツール専用のテストスクリプト
• token-test.mjs：DigitalOcean API トークンが正しく読み取れることを確認するユーティリティスクリプト

テストを実行するには：

# Run a test script
node tests/test-simple.mjs

Cursor との統合

Cursor で使用するには、以下を .cursor/mcp.json ファイルに追加します。

{
  "mcpServers": {
    "digitalocean": {
      "command": "node",
      "args": [
        "/path/to/your/project/build/index.js"
      ]
    }
  }
}