homebrew-mcp

gautampachnanda101/homebrew-mcp

3.1

If you are the rightful owner of homebrew-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 Model Context Protocol (MCP) Kubernetes Server is a tool designed to facilitate the management and deployment of Kubernetes clusters using the MCP framework.

Homebrew Tap for MCP Kubernetes Server

GitHub Release Homebrew

This is a Homebrew tap for the Model Context Protocol (MCP) Kubernetes Server. It provides easy installation and updates for mcp-k8s on macOS and Linux.

Quick Start

# Add the tap
brew tap gautampachnanda101/mcp

# Install mcp-k8s
brew install mcp-k8s

# Verify installation
mcp-k8s --version

Supported Platforms

OSArchitectureStatus
macOSIntel (x86_64)✅
macOSApple Silicon (ARM64)✅
Linuxx86_64✅
LinuxARM64✅

Installation Options

Standard Installation

# Tap and install in one command
brew install gautampachnanda101/mcp/mcp-k8s

With Specific Version

# Install specific version
brew install gautampachnanda101/mcp/mcp-k8s@0.1.1

Usage

Basic Commands

# Show help
mcp-k8s --help

# Test Kubernetes connection
mcp-k8s --test

# List available MCP tools
mcp-k8s --list-tools

Testing the Installation

# Quick connection test
mcp-k8s --test

# Expected output:
# ✅ Successfully connected to Kubernetes cluster
# Cluster: https://your-cluster-api
# Context: your-context

MCP Client Integration

Claude Desktop:

{
  "mcpServers": {
    "k8s": {
      "command": "mcp-k8s",
      "args": ["--log-level", "info"]
    }
  }
}

VS Code MCP Extension:

{
  "mcpServers": {
    "k8s": {
      "command": "mcp-k8s",
      "args": ["--kubeconfig", "/path/to/kubeconfig"]
    }
  }
}

Updating

# Update Homebrew
brew update

# Upgrade mcp-k8s
brew upgrade mcp-k8s

# Check current version
mcp-k8s --version

Uninstallation

# Uninstall mcp-k8s
brew uninstall mcp-k8s

# Optionally remove the tap
brew untap gautampachnanda101/mcp

Requirements

  • Kubernetes cluster access
  • Valid kubeconfig file (~/.kube/config or custom path)
  • kubectl configured (optional but recommended)

How It Works

  • Binaries: Downloaded from public releases
  • Formula: Automatically selects the correct binary for your platform
  • Updates: Managed through Homebrew's standard update mechanism
  • SHA256: All binaries are verified with SHA256 checksums

Troubleshooting

Formula Not Found

# Update Homebrew
brew update

# Tap the repository again
brew untap gautampachnanda101/mcp
brew tap gautampachnanda101/mcp

Version Conflicts

# Reinstall from scratch
brew uninstall mcp-k8s
brew install mcp-k8s

Permission Issues

# Ensure binary is executable
which mcp-k8s
ls -l $(which mcp-k8s)

# Should show executable permissions

Documentation

Other Installation Methods

If Homebrew isn't available on your system:

  • Direct Download: GitHub Releases
  • Install Script: curl -sSL https://github.com/gautampachnanda101/mcp-servers/releases/latest/download/install.sh | bash
  • Windows: Use PowerShell install script or manual download

See the Distribution Guide for all installation options.

Contributing

Found an issue with the formula? Please open an issue or PR:

License

MIT