assisted-service-mcp

openshift-assisted/assisted-service-mcp

3.4

If you are the rightful owner of assisted-service-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Assisted Service MCP Server is designed to interact with the OpenShift assisted installer API, providing tools for cluster management, events monitoring, and more.

The Assisted Service MCP Server is a specialized server that facilitates interaction with the OpenShift assisted installer API. It is designed to diagnose cluster failures and provide solutions for fixing them. The server can be configured to run using different transport methods, such as STDIO or SSE, allowing flexibility in how it is integrated into various development environments. By leveraging the OpenShift API token, users can manage clusters, monitor events, and perform a variety of tasks related to the OpenShift assisted installer. The server supports a range of tools for cluster management, infrastructure environment handling, host management, and more, making it a comprehensive solution for OpenShift cluster administration.

Features

  • Cluster Management: Tools for listing, creating, and installing clusters.
  • Events and Monitoring: Access to cluster and host events for troubleshooting.
  • Infrastructure Environment: Detailed information about infra environments.
  • Host Management: Update host roles within a cluster.
  • OpenShift Versions and Operators: Manage OpenShift versions and operator bundles.

Usages

usage with vscode stdio

"mcp": {
    "servers": {
        "AssistedService": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/assisted-service-mcp",
                "run",
                "mcp",
                "run",
                "/path/to/assisted-service-mcp/server.py"
            ],
            "env": {
                "OFFLINE_TOKEN": "<your token>"
            }
        }
    }
}

usage with terminal sse

bash
OFFLINE_TOKEN=<your token> uv run server.py

client configuration sse

"assisted-sse": {
  "transport": "sse",
  "url": "http://localhost:8000/sse"
}

client configuration sse with header

"assisted-sse": {
  "transport": "sse",
  "url": "http://localhost:8000/sse",
  "headers": {
    "OCM-Offline-Token": "<your token>"
  }
}

Tools

  1. list_clusters

    Lists all current user assisted installer clusters.

  2. cluster_info

    Get detailed information about a specific cluster.

  3. create_cluster

    Create a new assisted installer cluster and infraenv.

  4. install_cluster

    Trigger installation for a specific cluster.

  5. set_cluster_vips

    Set the API and ingress virtual IP addresses for a cluster.