MCP K8s Go

🚀 Golang ベースの MCP サーバーを Kubernetes に接続する

このプロジェクトは、Golang ベースの MCP サーバーを Kubernetes に接続するための機能を提供します。複数の Kubernetes クラスター構成を管理し、セキュリティを強化することができます。

✨ 主な機能

• サポートされる Kubernetes コンテキスト：複数の Kubernetes クラスター構成を一覧表示し、切り替えることができます。
• 許可されるコンテキスト：アクセスを許可する Kubernetes コンテキストを指定でき、セキュリティが強化されます。
• 環境変数構成：KUBECONFIG 環境変数を設定することで、Kubernetes 構成ファイルのパスを柔軟に指定できます。
• コマンドラインオプション：--allowed-contexts オプションを提供し、ユーザーがアクセスできる Kubernetes コンテキストの範囲を制限できます。

📦 インストール

事前構築済みバイナリの使用

npm を通じたインストール

npm install -g @strowk/mcp-k8s

次に、バージョンが正しく出力されることを確認します。

mcp-k8s --version

claude_desktop_config.json に以下の構成を追加します。

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "mcp-k8s",
      "args": []
    }
  }
}

GitHub リリース版を使用する

GitHub リリースページ から対象プラットフォームの最新バージョンをダウンロードし、解凍後、実行可能ファイルを PATH 環境変数に追加します。 claude_desktop_config.json に以下の構成を追加します。

{
  "mcpServers": {
    "mcp_k8s": {
      "command": "mcp-k8s-go",
      "args": []
    }
  }
}

ソースからコンパイルする

Golang がインストールされている場合は、以下のコマンドを実行してコンパイルとインストールを行います。

go get github.com/strowk/mcp-k8s-go
go install github.com/strowk/mcp-k8s-go

その後、claude_desktop_config.json に以下の構成を追加します。

{
  "mcpServers": {
    "mcp_k8s_go": {
      "command": "mcp-k8s-go",
      "args": []
    }
  }
}

Docker を使用する

バージョン 0.3.1-beta.2 から、イメージは Docker Hub に公開され、複数のプラットフォーム（linux/amd64 および linux/arm64）をサポートしています。 実行例：

docker run -i -v ~/.kube/config:/home/nonroot/.kube/config --rm mcpk8s/server:latest

Windows システムでは、パスを //c/Users/<username>/.kube/config のような形式に調整する必要がある場合があります。 Claude の構成については、以下のように設定します。

{
  "mcpServers": {
    "mcp_k8s_go": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-v",
        "~/.kube/config:/home/nonroot/.kube/config",
        "--rm",
        "mcpk8s/server:latest"
      ]
    }
  }
}

📚 ドキュメント

環境変数

• KUBECONFIG：Kubernetes 構成ファイルのパスを指定します（オプション、デフォルトは ~/.kube/config）

コマンドラインオプション

• --allowed-contexts=<ctx1,ctx2,...>：カンマ区切りのアクセスを許可する Kubernetes コンテキストのリスト。指定しない場合は、すべてのコンテキストにアクセスできます。
• --help：ヘルプ情報を表示します。
• --version：バージョン情報を表示します。