MCP Vultr

🚀 🌩️ Vultr MCP

Vultrクラウド管理に最適なモデルコンテキストプロトコルサーバー

自然言語コマンドでクラウドインフラストラクチャを変革しましょう

🚀 クイックスタート • 📖 ドキュメント • 🛠️ 主な機能 • 💡 使用例 • 🤝 コントリビュート

🚀 クイックスタート

📦 インストール

# 🏃‍♂️ uvを使った高速インストール（推奨）
uv add mcp-vultr

# 📦 従来のpipインストール
pip install mcp-vultr

⚙️ Claude Codeでのセットアップ

# 🔑 Vultr APIキーを設定
export VULTR_API_KEY="your-vultr-api-key"

# 🔌 Claude Codeに追加（1コマンドで！）
claude mcp add vultr vultr-mcp-server --env VULTR_API_KEY="${VULTR_API_KEY}"

🎉 管理を開始！

# 🚀 MCPサーバーを起動
vultr-mcp-server

以上で完了です！ これでClaude Codeで自然言語を使って335以上のVultr管理ツールを利用できます。

✨ 主な機能

🌟 コア機能

🎯 エンタープライズ機能 (v2.1.0)

🏗️ サービスカバレッジ (335以上のツール)

💻 使用例

🗣️ 自然言語コマンド

🧑‍💻 "ニュージャージーに'my-website'という名前のWebサーバーインスタンスを作成して"
🤖 ✅ ewrリージョンにインスタンス'my-website' (Ubuntu 22.04, 1GB RAM) を作成しました

🧑‍💻 "blog.example.comのDNSレコードをmy-websiteに向けて追加して"
🤖 ✅ Aレコードを追加しました: blog.example.com → 192.168.1.100 (TTL: 300)

🧑‍💻 "Kubernetesクラスターを5ノードにスケールして"
🤖 ✅ クラスター'production'のノードプールを5ノードにスケールしました

🧑‍💻 "今月のサービス別請求内訳を表示して"
🤖 📊 月次コスト: インスタンス $45, Kubernetes $120, ストレージ $23...

🐍 Python API

import asyncio
from mcp_vultr import VultrDNSClient, VultrDNSServer

async def deploy_website():
    """🚀 完全なWebサイトインフラストラクチャをデプロイ"""
    
    # 高レベルDNSクライアント
    dns = VultrDNSClient("your-api-key")
    
    # スマート識別子付きの完全なAPIクライアント
    vultr = VultrDNSServer("your-api-key")
    
    # 🌐 ドメインとDNSレコードを作成
    await dns.create_domain("mysite.com", "192.168.1.100") 
    await dns.add_a_record("mysite.com", "www", "192.168.1.100")
    await dns.add_mx_record("mysite.com", "@", "mail.mysite.com", 10)
    
    # 🖥️ スマートな名前でインスタンスをデプロイ
    instance = await vultr.create_instance(
        region="ewr",
        plan="vc2-1c-1gb", 
        os_id=387,
        label="web-server",  # 🏷️ 人間が読みやすい名前！
        hostname="web.mysite.com"
    )
    
    # 🔥 説明でファイアウォールを構成
    firewall = await vultr.get_firewall_group("web-servers")
    
    # 📊 リアルタイムメトリクスを取得
    stats = await vultr.get_instance_bandwidth("web-server")  # 名前で！
    
    print(f"✅ {instance['label']}を{stats['incoming']}GBのトラフィックでデプロイしました")

asyncio.run(deploy_website())

🖥️ エンタープライズCLI体験

✨ プロフェッショナルなテーブルを備えた美しいリッチインターフェイス

# 🌈 色とステータスインジケーターを備えた見事なドメイン概要
$ mcp-vultr domains list

                    Vultr DNS Domains (49 found)                     
┏━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┓
┃ Domain                  ┃ Created                   ┃ DNSSEC      ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━┩
│ api.mycompany.com       │ 2024-01-15T10:30:00+00:00 │ ✅ enabled  │
│ webapp.io               │ 2024-03-22T14:20:00+00:00 │ ❌ disabled │
│ blog.example.com        │ 2024-07-10T09:15:00+00:00 │ ✅ enabled  │
└─────────────────────────┴───────────────────────────┴─────────────┘

# 🚀 ブランド付きパネルを備えたプロフェッショナルなサーバー起動
$ mcp-vultr server
╭────────────────────────────── Vultr MCP Server ──────────────────────────────╮
│ 🚀 Starting Vultr DNS MCP Server                                             │
│ 🔑 API Key: your-key-abc123...                                               │
│ 🔄 Press Ctrl+C to stop                                                      │
╰──────────────────────────────────────────────────────────────────────────────╯

# 🏗️ スマートな名前でインフラストラクチャを管理
mcp-vultr instances create --label "api-server" --region ewr --plan vc2-2c-4gb
mcp-vultr instances start api-server                    # 名前で起動！
mcp-vultr instances attach-volume api-server db-storage # 名前でアタッチ！

# 🌐 リアルタイムフィードバックでDNSを管理
mcp-vultr domains create api.mycompany.com 192.168.1.200
mcp-vultr records add api.mycompany.com A @ 192.168.1.200
mcp-vultr setup-website api.mycompany.com 192.168.1.200 --ssl

# 🐳 Kubernetesクラスターを管理
mcp-vultr k8s create production-cluster --region ewr --nodes 3
mcp-vultr k8s scale production-cluster --nodes 5       # 名前でスケール！
mcp-vultr k8s get-costs production-cluster             # コスト分析！

📊 リアルタイムパフォーマンス監視と構造化ロギング

# 📈 ライブパフォーマンスメトリクスとキャッシュ統計
[info] API request completed    method=GET response_time=0.63s status_code=200
[debug] Cache set              cache_type=TTLCache endpoint=/domains hit_rate=85.2%
[debug] API call recorded      cache_hit=False duration=0.63s success=True

# 📊 P95/P99メトリクスを備えた美しいパフォーマンステーブル
                         API Performance Metrics                         
┏━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Endpoint      ┃ Requests ┃ Avg Time ┃    P95 ┃ Cache Hit ┃ Error Rate ┃
┡━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ GET /domains  │    1,247 │   0.234s │ 0.456s │     85.2% │       0.1% │
│ GET /records  │    3,891 │   0.189s │ 0.312s │     92.1% │       0.3% │
│ POST /records │      456 │   0.567s │ 1.234s │      0.0% │       2.1% │
└───────────────┴──────────┴──────────┴────────┴───────────┴────────────┘

🎯 スマート識別子解決

UUIDの煩わしさを解消しましょう！ Vultr MCPの魅力的な機能はスマート識別子解決です。すべてのサービスで暗号化されたUUIDの代わりに人間が読みやすい名前を使用できます。

🏷️ 変更前と変更後

# 😤 古い方法（到処にUUID）
vultr instance stop cb676a46-66fd-4dfb-b839-443f2e6c0b60
vultr firewall rule add 5f2a4b6c-7b8d-4e9f-a1b2-3c4d5e6f7a8b --port 443

# 🎉 Vultr MCPの方法（人間が読みやすい名前！）
mcp-vultr instances stop web-server
mcp-vultr firewall rules add web-servers --port 443

🧠 すべてのサービスでのスマート解決

🏗️ アーキテクチャ

┌─────────────────────────────────────────────────────────────────┐
│                        🤖 AI Assistant                          │
│                     (Claude Code/Desktop)                       │
└──────────────────────────┬──────────────────────────────────────┘
                           │ 自然言語コマンド
┌──────────────────────────▼──────────────────────────────────────┐
│                   📡 Vultr MCP Server                           │
│                      (335+ Tools)                               │
├─────────────────────────────────────────────────────────────────┤
│  🌐 DNS  🖥️ Compute  🐳 K8s  🗄️ DB  🔥 Security  💾 Storage    │
│  📊 Analytics  🌍 CDN  ⚖️ LB  🚀 Serverless  👥 Users          │
└──────────────────────────┬──────────────────────────────────────┘
                           │ スマートAPI呼び出し
┌──────────────────────────▼──────────────────────────────────────┐
│                      ☁️ Vultr Cloud API                         │
│              (完全なインフラストラクチャ管理)                │
└─────────────────────────────────────────────────────────────────┘

📚 ドキュメント

🚀 始めるには

• ⚡ クイックスタートガイド
• 🔧 インストールとセットアップ
• 🎯 Claude Codeでの最初のステップ

📚 APIリファレンス

• 🐍 Python APIドキュメント
• 🖥️ CLIコマンドリファレンス
• 🤖 MCPツールリファレンス

🎓 チュートリアルと使用例

• 🏗️ 自然言語でのインフラストラクチャコード
• 🌐 完全なWebサイトデプロイ
• ☸️ Kubernetesクラスター管理

🛠️ 開発

🏃‍♂️ クイックセットアップ

# 📥 リポジトリをクローン
git clone https://git.supported.systems/MCP/mcp-vultr.git
cd mcp-vultr

# ⚡ uvでインストール（推奨）
uv sync --extra dev

# 🧪 テストを実行（複数のパフォーマンスモード）
make test-fast          # ⚡ クイックテスト (30-60s)
make test-parallel      # 🚀 並列実行 (60-120s)
make test-coverage      # 📊 完全なカバレッジ (180-300s)

# 🎯 ターゲットテスト
make test-unit          # ユニットテストのみ
make test-mcp           # MCPサーバーテスト
make test-error         # エラーハンドリングテスト

# 📈 パフォーマンス監視
python test_performance_benchmark.py

# 🎨 コードをフォーマット
uv run black src tests && uv run isort src tests

# 🔍 型チェック
uv run mypy src

📦 ビルドと公開

# 🏗️ パッケージをビルド
uv build

# ✅ 整合性をチェック
uv run twine check dist/*

# 🚀 PyPIに公開
uv run twine upload dist/*

🤝 コントリビュート

私たちはコントリビューションを大歓迎です！以下のようなことができます。

• 🐛 バグレポート：問題を見つけたら、教えてください！
• ✨ 機能リクエスト：アイデアがあれば、聞きたいです！
• 📝 ドキュメント：ドキュメントをさらに良くする手助けをしてください
• 🧪 テスト：テストを追加し、カバレッジを向上させてください
• 💻 コード：新機能や修正のPRを提出してください

🚀 コントリビュートの方法

1. 🍴 リポジトリをフォーク
2. 🌿 機能ブランチを作成 (git checkout -b feature/amazing-feature)
3. ✍️ 変更を加える
4. ✅ すべてをテスト (make test-parallel または make test-coverage)
5. 📝 変更をコミット (git commit -m 'Add amazing feature')
6. 📤 ブランチにプッシュ (git push origin feature/amazing-feature)
7. 🎉 プルリクエストを作成

📊 プロジェクト統計

🙏 謝辞

• 🌩️ Vultr の包括的なクラウドAPI
• 🤖 Anthropic のモデルコンテキストプロトコル仕様
• 🐍 Pythonコミュニティ の素晴らしいツールとライブラリ
• 🚀 FastMCP の優れたMCPフレームワーク
• 👥 このプロジェクトを素晴らしくしてくれるコントリビューター

📄 ライセンス

このプロジェクトは MITライセンス の下でライセンスされています。詳細は LICENSE ファイルを参照してください。