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（一鍵完成！）
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內存）

🧑‍💻 "為blog.example.com添加一個指向my-website的DNS記錄"
🤖 ✅ 添加了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():
    """🚀 部署完整的網站基礎設施"""
    
    # 高級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)                       │
└──────────────────────────┬──────────────────────────────────────┘
                           │ Natural Language Commands
┌──────────────────────────▼──────────────────────────────────────┐
│                   📡 Vultr MCP Server                           │
│                      (335+ Tools)                               │
├─────────────────────────────────────────────────────────────────┤
│  🌐 DNS  🖥️ Compute  🐳 K8s  🗄️ DB  🔥 Security  💾 Storage    │
│  📊 Analytics  🌍 CDN  ⚖️ LB  🚀 Serverless  👥 Users          │
└──────────────────────────┬──────────────────────────────────────┘
                           │ Smart API Calls
┌──────────────────────────▼──────────────────────────────────────┐
│                      ☁️ Vultr Cloud API                         │
│              (Complete Infrastructure Management)                │
└─────────────────────────────────────────────────────────────────┘

📚 詳細文檔

🚀 入門指南

• ⚡ 快速開始指南
• 🔧 安裝與設置
• 🎯 使用Claude Code的第一步

📚 API參考

• 🐍 Python API文檔
• 🖥️ CLI命令參考
• 🤖 MCP工具參考

🎓 教程與示例

• 🏗️ 使用自然語言進行基礎設施即代碼
• 🌐 完整網站部署
• ☸️ Kubernetes集群管理

🛠️ 開發

🏃‍♂️ 快速設置

# 📥 克隆倉庫
git clone https://git.supported.systems/MCP/mcp-vultr.git
cd mcp-vultr

# ⚡ 使用uv安裝（推薦）
uv sync --extra dev

# 🧪 運行測試（多種性能模式）
make test-fast          # ⚡ 快速測試（30 - 60秒）
make test-parallel      # 🚀 並行執行（60 - 120秒）
make test-coverage      # 📊 全覆蓋測試（180 - 300秒）

# 🎯 針對性測試
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/*

🤝 貢獻代碼

我們歡迎貢獻！無論是：

• 🐛 Bug報告：發現問題？告訴我們！
• ✨ 功能請求：有想法？我們想聽！
• 📝 文檔編寫：幫助我們完善文檔
• 🧪 測試工作：添加測試，提高覆蓋率
• 💻 代碼提交：提交新功能或修復的PR

🚀 如何貢獻

1. 🍴 Fork 倉庫
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. 🎉 打開 一個Pull Request

📊 項目統計

🙏 致謝

• 🌩️ Vultr 提供全面的雲API
• 🤖 Anthropic 提供模型上下文協議規範
• 🐍 Python社區 提供出色的工具和庫
• 🚀 FastMCP 提供優秀的MCP框架
• 👥 貢獻者 讓這個項目變得出色

📄 許可證

本項目採用 MIT許可證 - 詳情請參閱 LICENSE 文件。