power_on_digitalocean_droplet
Activate a DigitalOcean droplet by confirming its ID, IP address, name, and operation type. This tool ensures secure power-on actions for cloud server management.
Instructions
开启DigitalOcean Droplet（需要三次确认）
Args:
droplet_id (int): Droplet ID
ip_confirmation (str): 确认IP地址
name_confirmation (str): 确认Droplet名称
operation_confirmation (str): 确认操作类型（输入"开机"或"power_on"）
Returns:
Dict: 操作结果或确认要求
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| droplet_id | Yes | ||
| ip_confirmation | No | ||
| name_confirmation | No | ||
| operation_confirmation | No |
Implementation Reference
- main.py:395-417 (handler)MCP tool registration and handler for 'power_on_digitalocean_droplet'. This function is decorated with @mcp.tool() and delegates the execution to digitalocean_provider.power_on_droplet after parameter passing.@mcp.tool() def power_on_digitalocean_droplet( droplet_id: int, ip_confirmation: str = "", name_confirmation: str = "", operation_confirmation: str = "" ) -> Dict: """ 开启DigitalOcean Droplet（需要三次确认） Args: droplet_id (int): Droplet ID ip_confirmation (str): 确认IP地址 name_confirmation (str): 确认Droplet名称 operation_confirmation (str): 确认操作类型（输入"开机"或"power_on"） Returns: Dict: 操作结果或确认要求 """ return digitalocean_provider.power_on_droplet( droplet_id, ip_confirmation, name_confirmation, operation_confirmation )
- Provider method implementing power_on_droplet, which invokes the shared _execute_power_operation with 'power_on' action.def power_on_droplet( self, droplet_id: int, ip_confirmation: str = "", name_confirmation: str = "", operation_confirmation: str = "" ) -> Dict: """ 开启Droplet（需要三次确认） Args: droplet_id (int): Droplet ID ip_confirmation (str): IP地址确认 name_confirmation (str): 名称确认 operation_confirmation (str): 操作确认 Returns: Dict: 操作结果或确认要求 """ return self._execute_power_operation( droplet_id, 'power_on', ip_confirmation, name_confirmation, operation_confirmation )
- Core handler implementing the power operation logic for DigitalOcean droplets. Performs security triple confirmation, validates inputs, and executes the API call to client.droplet_actions.post.def _execute_power_operation( self, droplet_id: int, operation: str, ip_confirmation: str, name_confirmation: str, operation_confirmation: str ) -> Dict: """ 执行电源操作的通用函数 """ if not self.available: return { 'error': f'DigitalOcean服务不可用: {getattr(self, "error", "未知错误")}', 'provider': 'digitalocean' } # 首先获取droplet信息 try: droplet_response = self.client.droplets.get(droplet_id) droplet = droplet_response.get("droplet", {}) if not droplet: return { 'error': f'未找到ID为 {droplet_id} 的Droplet', 'provider': 'digitalocean' } # 格式化droplet信息用于确认 droplet_info = self._format_droplet_for_confirmation(droplet) except Exception as e: return { 'error': f'获取Droplet信息时发生错误: {str(e)}', 'provider': 'digitalocean' } # 检查是否提供了确认信息 if not ip_confirmation or not name_confirmation or not operation_confirmation: # 返回确认要求 return require_triple_confirmation(droplet_info, operation) # 验证确认信息 security = SecurityConfirmation() is_valid, error_message = security.validate_power_operation( droplet_info, operation, ip_confirmation, name_confirmation, operation_confirmation ) if not is_valid: return { 'error': f'确认验证失败: {error_message}', 'provider': 'digitalocean', 'requires_confirmation': True } # 执行实际操作 try: action_data = {"type": operation} response = self.client.droplet_actions.post(droplet_id=droplet_id, body=action_data) action = response.get("action", {}) return { 'provider': 'digitalocean', 'droplet_id': droplet_id, 'operation_success': True, 'action': { 'id': action.get("id"), 'status': action.get("status"), 'type': action.get("type"), 'started_at': action.get("started_at"), 'resource_id': action.get("resource_id") }, 'message': f'已成功提交 {operation} 操作，操作ID: {action.get("id")}', 'confirmation_validated': True } except Exception as e: return { 'error': f'执行 {operation} 操作时发生错误: {str(e)}', 'provider': 'digitalocean' }
- Helper function to format droplet information specifically for the security confirmation process used in power operations.def _format_droplet_for_confirmation(self, droplet: Dict) -> Dict: """格式化Droplet信息用于确认流程""" networks = droplet.get("networks", {}) public_ip = None for net in networks.get("v4", []): if net.get("type") == "public": public_ip = net.get("ip_address") break return { 'public_ip': public_ip or droplet.get('public_ipv4', '未知'), 'name': droplet.get("name", '未知'), 'status': droplet.get("status"), 'instance_id': droplet.get("id"), 'instance_type': droplet.get("size_slug"), 'tags': droplet.get("tags", []) }