Claude Kubernetes MCP Server

Claude Kubernetes MCP サーバー

Kubernetes API のコンテキストと、必要に応じて ArgoCD や GitLab の情報を使い、Claude とともに Kubernetes クラスターに関する質問に答える Go サーバーです。

ドキュメント：docs.blankcut.com/kubernetes-mcp-server — クイックスタート、インストール方法、すべての設定キーとエンドポイント、トラブルシューティングを掲載しています。

できること

• クラスターを読み取ります — 名前空間、あらゆるリソースタイプ（カスタムリソースも含む）、イベント、リソース、関連性、ヘルス状態を名前空間ごとにまとめたマップを確認できます。
• Claude を使わずに問題を検出します — Warning イベントと失敗した CronJob（失敗した実行のログ末尾を含む）を、数秒で問題の一覧にまとめます（?narrative=false）。
• Claude に質問します — 収集したコンテキストを使って、リソース、名前空間全体、または GitLab のマージリクエストについて質問できます。
• ArgoCD へのアクセス状態を監視します — 60 秒ごとにトークンで Applications を読み取れることを確認するため、RBAC 権限が失われると、空の一覧ではなくエラーとして表示されます。
• API キーまたは Workload Identity Federation で Claude に認証します — 長期間有効なキーなしで実行できます。

読み取り専用です。Kubernetes、ArgoCD、GitLab の内容を変更することはありません。

これは REST API です。名称にかかわらず、Model Context Protocol の JSON-RPC トランスポートは実装していないため、Claude Desktop などの MCP クライアントから直接接続することはできません。HTTP 経由で呼び出してください。

クイックスタート

Releases からリリースバイナリ（Linux および macOS、amd64 および arm64）をダウンロードし、config.yaml を作成します。

server:
  address: ":8080"
  writeTimeout: 300
  auth:
    apiKey: "${API_KEY}"
kubernetes:
  inCluster: false          # uses $KUBECONFIG or ~/.kube/config
claude:
  apiKey: "${CLAUDE_API_KEY}"
  baseURL: "https://api.anthropic.com"
  modelID: "claude-sonnet-5"
  maxTokens: 8192

次に、実行します。

export API_KEY=$(openssl rand -hex 32) CLAUDE_API_KEY=sk-ant-...
./mcp-server-darwin-arm64 --config config.yaml

curl -s -H "X-API-Key: $API_KEY" \
  "http://localhost:8080/api/v1/namespaces/default/analysis?narrative=false"

クイックスタートでは、チェックサムの検証も含めて手順を説明しています。

インストール

方法
Helm	リリースタグをチェックアウトした状態で、helm install kubernetes-mcp-server ./helm/kubernetes-mcp-server --set secrets.apiKey=... --set secrets.claudeApiKey=... を実行します。インストールをご覧ください。
Docker	blankcut/kubernetes-mcp-server（linux/amd64、linux/arm64）。設定ファイルを /app/config.yaml にマウントします。
バイナリ	checksums.txt を含む Releases。
ソース	Go 1.26 以降：cd kubernetes-claude-mcp && go build -o mcp-server ./cmd/server。

開発

cd kubernetes-claude-mcp
go test ./...
go run ./cmd/server --config config.yaml --log-level debug

Postman コレクションは postman/ にあります。変更内容は CHANGELOG.md に記載しています。貢献を歓迎します。詳細は CONTRIBUTING.md をご覧ください。

寄付

すばらしい取り組みを続けるため、コーヒー基金へのご支援をお願いします：Buy Me Coffee

License

MIT