OCI MCP Server

Instructions

Implementation Reference

• mcp_server_oci/tools/oke.py:355-392 (handler)

  Core handler function that executes the logic to fetch kubeconfig from OCI Container Engine using the create_kubeconfig API.
  def get_cluster_kubeconfig(container_engine_client: oci.container_engine.ContainerEngineClient, cluster_id: str) -> Dict[str, Any]: """ Get the kubeconfig for a specific OKE cluster. Args: container_engine_client: OCI ContainerEngine client cluster_id: OCID of the cluster Returns: Kubeconfig content and metadata """ try: # Create kubeconfig request create_kubeconfig_details = oci.container_engine.models.CreateClusterKubeconfigContentDetails() # Get the kubeconfig kubeconfig_response = container_engine_client.create_kubeconfig( cluster_id, create_kubeconfig_details ) # Read the kubeconfig content kubeconfig_content = kubeconfig_response.data.content.decode('utf-8') if hasattr(kubeconfig_response.data, 'content') else kubeconfig_response.data.text result = { "cluster_id": cluster_id, "kubeconfig": kubeconfig_content, "format": "yaml", "usage": "Save this content to ~/.kube/config or use with kubectl --kubeconfig flag", } logger.info(f"Retrieved kubeconfig for cluster {cluster_id}") return result except Exception as e: logger.exception(f"Error getting cluster kubeconfig: {e}") raise
• mcp_server_oci/mcp_server.py:1865-1882 (registration)

  MCP tool registration with name 'get_oke_cluster_kubeconfig' and wrapper handler that invokes the core implementation from oke.py.
  @mcp.tool(name="get_oke_cluster_kubeconfig") @mcp_tool_wrapper( start_msg="Getting kubeconfig for cluster {cluster_id}...", error_prefix="Error getting cluster kubeconfig" ) async def mcp_get_oke_cluster_kubeconfig(ctx: Context, cluster_id: str) -> Dict[str, Any]: """ Get the kubeconfig file content for accessing an OKE cluster. Args: cluster_id: OCID of the cluster Returns: Kubeconfig content in YAML format that can be saved to ~/.kube/config or used with kubectl --kubeconfig flag """ return get_cluster_kubeconfig(oci_clients["container_engine"], cluster_id)
• mcp_server_oci/mcp_server.py:128-136 (helper)

  Import statement that brings the get_cluster_kubeconfig helper function into scope for use in the MCP server.
  from mcp_server_oci.tools.oke import ( list_clusters, get_cluster, list_node_pools, get_node_pool, get_cluster_kubeconfig, list_work_requests, get_work_request, )