GCP MCP

Instructions

    List Cloud Storage buckets in a GCP project.
    
    Args:
        project_id: The ID of the GCP project to list buckets for
    
    Returns:
        List of Cloud Storage buckets in the specified GCP project
    

Implementation Reference

• src/gcp_mcp/gcp_modules/storage/tools.py:9-48 (handler)

  The handler function for the 'list_storage_buckets' tool, decorated with @mcp.tool(), which lists GCP Cloud Storage buckets for a given project using the google.cloud.storage client.

      @mcp.tool()
      def list_storage_buckets(project_id: str) -> str:
          """
          List Cloud Storage buckets in a GCP project.
          
          Args:
              project_id: The ID of the GCP project to list buckets for
          
          Returns:
              List of Cloud Storage buckets in the specified GCP project
          """
          try:
              from google.cloud import storage
              
              # Initialize the Storage client
              client = storage.Client(project=project_id)
              
              # List buckets
              buckets = client.list_buckets()
              
              # Format the response
              buckets_list = []
              for bucket in buckets:
                  location = bucket.location or "Unknown"
                  storage_class = bucket.storage_class or "Unknown"
                  created = bucket.time_created.strftime("%Y-%m-%d %H:%M:%S UTC") if bucket.time_created else "Unknown"
                  buckets_list.append(f"- {bucket.name} (Location: {location}, Class: {storage_class}, Created: {created})")
              
              if not buckets_list:
                  return f"No Cloud Storage buckets found in project {project_id}."
              
              buckets_str = "\n".join(buckets_list)
              
              return f"""
  Cloud Storage Buckets in GCP Project {project_id}:
  {buckets_str}
  """
          except Exception as e:
              return f"Error listing Cloud Storage buckets: {str(e)}"

• src/gcp_mcp/server.py:41-42 (registration)

  Registration call for storage tools module, which includes the list_storage_buckets tool, invoked within the main register_tools function.

  # Register storage tools
  storage_tools.register_tools(mcp)

• src/gcp_mcp/gcp_modules/storage/tools.py:6-8 (registration)

  The register_tools function in the storage module where the list_storage_buckets tool is defined and registered via decorator when called.

  def register_tools(mcp):
      """Register all storage tools with the MCP server."""