Cloud Manage MCP Server

Instructions

Implementation Reference

• main.py:324-340 (handler)

  MCP tool handler for get_aws_instance_info: decorated with @mcp.tool(), routes input to appropriate aws_provider method based on whether input starts with 'i-' (instance ID) or not (IP). Includes type hints and docstring serving as schema.
  @mcp.tool() def get_aws_instance_info(ip_address_or_id: str) -> Dict: """ 获取AWS EC2实例信息（只读） Args: ip_address_or_id (str): 公网IP地址或实例ID Returns: Dict: AWS实例信息 """ # 判断是IP地址还是实例ID if ip_address_or_id.startswith('i-'): return aws_provider.get_instance_by_id(ip_address_or_id) else: return aws_provider.get_instance_by_ip(ip_address_or_id)
• providers/aws_provider.py:52-116 (helper)

  Core helper method implementing AWS EC2 instance lookup by public IP using boto3 describe_instances with 'ip-address' filter, formats result with _format_instance_info.
  def get_instance_by_ip(self, ip_address: str) -> Dict: """ 根据公网IP地址查找EC2实例 Args: ip_address (str): 公网IP地址 Returns: Dict: 实例信息或错误信息 """ if not self.available: return { 'error': f'AWS服务不可用: {getattr(self, "error", "未知错误")}', 'provider': 'aws' } try: # 查找具有指定公网IP的实例 response = self.ec2.describe_instances( Filters=[ { 'Name': 'ip-address', 'Values': [ip_address] }, { 'Name': 'instance-state-name', 'Values': ['pending', 'running', 'shutting-down', 'terminated', 'stopping', 'stopped'] } ] ) instances = [] for reservation in response['Reservations']: for instance in reservation['Instances']: instances.append(instance) if not instances: return { 'provider': 'aws', 'found': False, 'message': f'未找到使用IP地址 {ip_address} 的EC2实例', 'searched_region': self.region } # 获取第一个匹配的实例的详细信息 instance = instances[0] instance_info = self._format_instance_info(instance) return { 'provider': 'aws', 'found': True, 'instance_info': instance_info } except ClientError as e: return { 'error': f'AWS API调用失败: {str(e)}', 'provider': 'aws' } except Exception as e: return { 'error': f'查询EC2实例时发生错误: {str(e)}', 'provider': 'aws' }
• providers/aws_provider.py:117-162 (helper)

  Core helper method implementing AWS EC2 instance lookup by instance ID using boto3 describe_instances(InstanceIds), formats result with _format_instance_info.
  def get_instance_by_id(self, instance_id: str) -> Dict: """ 根据实例ID查找EC2实例 Args: instance_id (str): EC2实例ID Returns: Dict: 实例信息或错误信息 """ if not self.available: return { 'error': f'AWS服务不可用: {getattr(self, "error", "未知错误")}', 'provider': 'aws' } try: response = self.ec2.describe_instances(InstanceIds=[instance_id]) if not response['Reservations']: return { 'provider': 'aws', 'found': False, 'message': f'未找到ID为 {instance_id} 的EC2实例' } instance = response['Reservations'][0]['Instances'][0] instance_info = self._format_instance_info(instance) return { 'provider': 'aws', 'found': True, 'instance_info': instance_info } except ClientError as e: return { 'error': f'AWS API调用失败: {str(e)}', 'provider': 'aws' } except Exception as e: return { 'error': f'查询EC2实例时发生错误: {str(e)}', 'provider': 'aws' }
• providers/aws_provider.py:343-382 (helper)

  Private helper method used by both get_instance_by_ip and get_instance_by_id to format raw AWS instance data into a standardized dictionary.
  def _format_instance_info(self, instance: Dict) -> Dict: """格式化实例详细信息""" # 获取名称标签 name = '未命名' for tag in instance.get('Tags', []): if tag['Key'] == 'Name': name = tag['Value'] break # 格式化网络信息 public_ip = instance.get('PublicIpAddress') private_ip = instance.get('PrivateIpAddress') # 格式化安全组 security_groups = [sg['GroupName'] for sg in instance.get('SecurityGroups', [])] # 格式化标签 tags = {tag['Key']: tag['Value'] for tag in instance.get('Tags', [])} return { 'instance_id': instance.get('InstanceId'), 'name': name, 'instance_type': instance.get('InstanceType'), 'state': instance.get('State', {}).get('Name'), 'public_ip': public_ip, 'private_ip': private_ip, 'availability_zone': instance.get('Placement', {}).get('AvailabilityZone'), 'launch_time': instance.get('LaunchTime').isoformat() if instance.get('LaunchTime') else None, 'platform': instance.get('Platform', 'Linux/UNIX'), 'architecture': instance.get('Architecture'), 'virtualization_type': instance.get('VirtualizationType'), 'root_device_type': instance.get('RootDeviceType'), 'security_groups': security_groups, 'subnet_id': instance.get('SubnetId'), 'vpc_id': instance.get('VpcId'), 'tags': tags, 'monitoring_state': instance.get('Monitoring', {}).get('State'), 'ebs_optimized': instance.get('EbsOptimized', False) }
• main.py:324-340 (registration)

  The @mcp.tool() decorator registers this function as an MCP tool.
  @mcp.tool() def get_aws_instance_info(ip_address_or_id: str) -> Dict: """ 获取AWS EC2实例信息（只读） Args: ip_address_or_id (str): 公网IP地址或实例ID Returns: Dict: AWS实例信息 """ # 判断是IP地址还是实例ID if ip_address_or_id.startswith('i-'): return aws_provider.get_instance_by_id(ip_address_or_id) else: return aws_provider.get_instance_by_ip(ip_address_or_id)