DescribeVSwitches

Instructions

Implementation Reference

• src/alibaba_cloud_ops_mcp_server/config.py:18-21 (registration)

  Configuration entry listing 'DescribeVSwitches' as one of the APIs/tools to register for the VPC service.

  'Vpc': [
      'DescribeVpcs',
      'DescribeVSwitches'
  ],

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

  Iterates over the config to dynamically register tools like DescribeVSwitches by calling _create_and_decorate_tool for each service API pair.

  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 logic executed by the dynamic tool for DescribeVSwitches: fetches API metadata, constructs request, calls Alibaba Cloud OpenAPI client, and returns response.

  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:142-203 (schema)

  Dynamically generates the input schema for the DescribeVSwitches tool based on Alibaba Cloud API metadata.

  def _create_function_schemas(service, api, api_meta):
      schemas = {}
      schemas[api] = {}
      parameters = api_meta.get('parameters', [])
  
      required_params = []
      optional_params = []
  
      for parameter in parameters:
          name = parameter.get('name')
          # TODO 目前忽略了带'.'的参数
          if '.' in name:
              continue
          schema = parameter.get('schema', '')
          required = schema.get('required', False)
  
          if required:
              required_params.append(parameter)
          else:
              optional_params.append(parameter)
  
      def process_parameter(parameter):
          name = parameter.get('name')
          schema = parameter.get('schema', '')
          description = schema.get('description', '')
          example = schema.get('example', '')
          type_ = schema.get('type', '')
          description = f'{description} 参数类型: {type_},参数示例：{example}'
          required = schema.get('required', False)
  
          if service.lower() == 'ecs' and name in ECS_LIST_PARAMETERS and type_ == 'string':
              python_type = list
          else:
              python_type = type_map.get(type_, str)
  
          field_info = (
              python_type,
              field(
                  default=None,
                  metadata={'description': description, 'required': required}
              )
          )
          return name, field_info
  
      for parameter in required_params:
          name, field_info = process_parameter(parameter)
          schemas[api][name] = field_info
  
      for parameter in optional_params:
          name, field_info = process_parameter(parameter)
          schemas[api][name] = field_info
  
      if 'RegionId' not in schemas[api]:
          schemas[api]['RegionId'] = (
              str,
              field(
                  default='cn-hangzhou',
                  metadata={'description': '地域ID', 'required': False}
              )
          )
      return schemas

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

  Helper that creates and registers the dynamic tool handler for specific APIs like DescribeVSwitches, naming it 'VPC_DESCRIBEVSWITCHES'.

  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