OCI MCP Server

Instructions

List all compute shapes available in a compartment.

Args:
    compartment_id: OCID of the compartment

Returns:
    List of shapes with CPU, memory, network, and GPU specifications

Implementation Reference

• mcp_server_oci/mcp_server.py:1360-1376 (handler)

  MCP tool handler for 'list_shapes'. This async function is decorated with @mcp.tool(name='list_shapes') and calls the underlying list_shapes helper with the compute client and compartment_id.

  @mcp.tool(name="list_shapes")
  @mcp_tool_wrapper(
      start_msg="Listing compute shapes in compartment {compartment_id}...",
      error_prefix="Error listing shapes"
  )
  async def mcp_list_shapes(ctx: Context, compartment_id: str) -> List[Dict[str, Any]]:
      """
      List all compute shapes available in a compartment.
  
      Args:
          compartment_id: OCID of the compartment
  
      Returns:
          List of shapes with CPU, memory, network, and GPU specifications
      """
      return list_shapes(oci_clients["compute"], compartment_id)

• mcp_server_oci/tools/resources.py:165-222 (helper)

  Core helper function that implements the OCI API call to list shapes, formats the response into a list of dictionaries with detailed shape specifications, and handles errors.

  def list_shapes(compute_client: oci.core.ComputeClient, compartment_id: str) -> List[Dict[str, Any]]:
      """
      List all shapes available in a compartment.
      
      Args:
          compute_client: OCI Compute client
          compartment_id: OCID of the compartment
          
      Returns:
          List of shapes with their details
      """
      try:
          shapes_response = oci.pagination.list_call_get_all_results(
              compute_client.list_shapes,
              compartment_id
          )
          
          shapes = []
          for shape in shapes_response.data:
              shapes.append({
                  "shape": shape.shape,
                  "processor_description": shape.processor_description,
                  "ocpus": shape.ocpus,
                  "memory_in_gbs": shape.memory_in_gbs,
                  "networking_bandwidth_in_gbps": shape.networking_bandwidth_in_gbps,
                  "max_vnic_attachments": shape.max_vnic_attachments,
                  "gpus": shape.gpus,
                  "gpu_description": shape.gpu_description,
                  "local_disks": shape.local_disks,
                  "local_disks_total_size_in_gbs": shape.local_disks_total_size_in_gbs,
                  "local_disk_description": shape.local_disk_description,
                  "rdma_ports": shape.rdma_ports,
                  "rdma_bandwidth_in_gbps": shape.rdma_bandwidth_in_gbps,
                  "is_live_migration_supported": shape.is_live_migration_supported,
                  "ocpu_options": {
                      "min": shape.ocpu_options.min if shape.ocpu_options else None,
                      "max": shape.ocpu_options.max if shape.ocpu_options else None,
                  } if shape.ocpu_options else None,
                  "memory_options": {
                      "min_in_g_bs": shape.memory_options.min_in_g_bs if shape.memory_options else None,
                      "max_in_g_bs": shape.memory_options.max_in_g_bs if shape.memory_options else None,
                      "default_per_ocpu_in_g_bs": shape.memory_options.default_per_ocpu_in_g_bs if shape.memory_options else None,
                      "min_per_ocpu_in_g_bs": shape.memory_options.min_per_ocpu_in_g_bs if shape.memory_options else None,
                      "max_per_ocpu_in_g_bs": shape.memory_options.max_per_ocpu_in_g_bs if shape.memory_options else None,
                  } if shape.memory_options else None,
                  "networking_bandwidth_options": {
                      "min_in_gbps": shape.networking_bandwidth_options.min_in_gbps if shape.networking_bandwidth_options else None,
                      "max_in_gbps": shape.networking_bandwidth_options.max_in_gbps if shape.networking_bandwidth_options else None,
                      "default_per_ocpu_in_gbps": shape.networking_bandwidth_options.default_per_ocpu_in_gbps if shape.networking_bandwidth_options else None,
                  } if shape.networking_bandwidth_options else None,
              })
          
          logger.info(f"Found {len(shapes)} shapes in compartment {compartment_id}")
          return shapes
          
      except Exception as e:
          logger.exception(f"Error listing shapes: {e}")
          raise

• mcp_server_oci/mcp_server.py:1360-1360 (registration)

  MCP tool registration decorator specifying the tool name as 'list_shapes'.

  @mcp.tool(name="list_shapes")