DescribeSecurityGroups

Instructions

Implementation Reference

• src/alibaba_cloud_ops_mcp_server/config.py:8-17 (registration)

  Configuration listing the 'DescribeSecurityGroups' tool under the 'ecs' service, which triggers its dynamic registration.

  'ecs': [
      'DescribeInstances',
      'DescribeRegions',
      'DescribeZones',
      'DescribeAccountAttributes',
      'DescribeAvailableResource',
      'DescribeImages',
      'DescribeSecurityGroups',
      'DeleteInstances'
  ],

• src/alibaba_cloud_ops_mcp_server/server.py:88-88 (registration)

  Calls create_api_tools with the config to register all configured tools, including DescribeSecurityGroups.

  api_tools.create_api_tools(mcp, config)

• src/alibaba_cloud_ops_mcp_server/tools/api_tools.py:267-271 (registration)

  Dynamically registers a tool for each API name listed in config, including 'DescribeSecurityGroups' for service 'ecs'.

  def create_api_tools(mcp: FastMCP, config:dict):
      for service_code, apis in config.items():
          for api_name in apis:
              _create_and_decorate_tool(mcp, service_code, api_name)

• src/alibaba_cloud_ops_mcp_server/tools/api_tools.py:100-135 (handler)

  Core handler function executed by the dynamic tool for DescribeSecurityGroups, performing the Alibaba Cloud ECS API call.

  def _tools_api_call(service: str, api: str, parameters: dict, ctx: Context):
      service = service.lower()
      api_meta, _ = ApiMetaClient.get_api_meta(service, api)
      version = ApiMetaClient.get_service_version(service)
      method = 'POST' if api_meta.get('methods', [])[0] == 'post' else 'GET'
      path = api_meta.get('path', '/')
      style = ApiMetaClient.get_service_style(service)
      
      # Handling special parameter formats
      processed_parameters = parameters.copy()
      processed_parameters = {k: v for k, v in processed_parameters.items() if v is not None}
      if service == 'ecs':
          for param_name, param_value in parameters.items():
              if param_name in ECS_LIST_PARAMETERS and isinstance(param_value, list):
                  processed_parameters[param_name] = json.dumps(param_value)
      
      req = open_api_models.OpenApiRequest(
          query=OpenApiUtilClient.query(processed_parameters)
      )
      params = open_api_models.Params(
          action=api,
          version=version,
          protocol='HTTPS',
          pathname=path,
          method=method,
          auth_type='AK',
          style=style,
          req_body_type='formData',
          body_type='json'
      )
      logger.info(f'Call API Request: Service: {service} API: {api} Method: {method} Parameters: {processed_parameters}')
      client = create_client(service, processed_parameters.get('RegionId', 'cn-hangzhou'))
      runtime = util_models.RuntimeOptions()
      resp = client.call_api(params, req, runtime)
      logger.info(f'Call API Response: {resp}')
      return resp

• src/alibaba_cloud_ops_mcp_server/tools/api_tools.py:256-266 (schema)

  Creates the dynamic tool handler and input schema using API metadata for DescribeSecurityGroups, registers it with name 'ECS_DESCRIBESECURITYGROUPS'.

  def _create_and_decorate_tool(mcp: FastMCP, service: str, api: str):
      """Create a tool function for an AlibabaCloud openapi."""
      api_meta, _ = ApiMetaClient.get_api_meta(service, api)
      fields = _create_function_schemas(service, api, api_meta).get(api, {})
      description = api_meta.get('summary', '')
      dynamic_lambda = _create_tool_function_with_signature(service, api, fields, description)
      function_name = f'{service.upper()}_{api}'
      decorated_function = mcp.tool(name=function_name)(dynamic_lambda)
  
      return decorated_function