Install MCP Server Locally

Kloudfuse developed a Model Context Protocol (MCP) Server to help platform engineers and SREs diagnose problems in their environment. It acts as a bridge between an AI model and external tools or data sources. It translates the AI’s requests into queries that can be used to investigate problems/issues and provide insights to various systems.

There are two ways to run the Kloudfuse MCP Server:

Local MCP Server

Run a local instance of the MCP Server with Docker. The MCP client launches the container and communicates with it directly.

Prerequisites

  • Docker is installed on your local machine

  • Access Kloudfuse Image Repo via API token (token.json)

  • Service Account Token

  • An MCP client

NOTE: This is a private Docker repository. You will need credentials from Kloudfuse to pull the MCP Server image

Installation

cat token.json | docker login -u _json_key --password-stdin https://us.gcr.io

docker pull us.gcr.io/mvp-demo-301906/kfuse/kf-mcp:latest
After every Kloudfuse release, pull the latest Docker image to ensure you have the most up-to-date MCP Server.

Client Configuration

This section provides configuration examples for connecting your MCP client to a local Kloudfuse MCP Server. The examples below use Claude Desktop, but the configuration approach can be adapted to other MCP clients.

You will need to add the following content to the claude_desktop_config.json

MacOS - ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows - %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kf-mcp-<ALIAS>": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KF_URL",
        "-e",
        "KF_TOKEN",
        "us.gcr.io/mvp-demo-301906/kfuse/kf-mcp:latest"
      ],
      "env": {
        "KF_URL": "<KLOUDFUSE_URL>",
        "KF_TOKEN": "<KLOUDFUSE_SERVICE_TOKEN>"
      }
    }
  }
}
json

Replace the following values:

  • <ALIAS>: The name you want to use for reference when using your MCP client

  • <KLOUDFUSE_URL>: Your Kloudfuse instance URL

  • <KLOUDFUSE_SERVICE_TOKEN>: A Kloudfuse Service Account Token

Note: Access will be limited based upon the service token that is used.