Helm MCP

mcp-helm

AI アシスタントから実際の Helm チャートデータにアクセスできるようにします。values.yaml の幻覚はもうありません。

これは何ですか？

Claude、Cursor、その他の AI アシスタントに Kubernetes デプロイを手伝うよう頼んでも、Helm チャートのスキーマにはアクセスできません。そのため推測してしまい、もっともらしく見えても実際とは一致しない答えになります。

mcp-helm がない場合：

• :x: 正しそうに見えても存在しないフィールド名を幻覚します
• :x: 古い、または非推奨のチャートバージョンを提案します
• :x: Web の取得や推測にトークンを浪費します

mcp-helm がある場合：

• :white_check_mark: 実際の Helm リポジトリを照会して、本物のチャートデータを取得します
• :white_check_mark: 最新のチャートバージョンを自動的に取得します
• :white_check_mark: 最初から正しい設定を行えます

mcp-helm は、AI アシスタントが外部データソースにアクセスするための標準的な方法である Model Context Protocol (MCP) を実装しています。

今すぐ試す

公開インスタンスを使うには、エディターの MCP 設定に次を追加してください（レート制限あり、インストール不要）：

{
  "mcpServers": {
    "helm": {
      "type": "http",
      "url": "https://helm-mcp.kubedoll.com/mcp"
    }
  }
}

次に、AI に「bitnami/postgresql チャートではどのような値を設定できますか？」と尋ねてみてください。

エディターの設定

{
  "mcpServers": {
    "helm": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/kubedoll-heavy-industries/mcp-helm", "--transport=stdio"]
    }
  }
}

{
  "mcpServers": {
    "helm": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/kubedoll-heavy-industries/mcp-helm", "--transport=stdio"]
    }
  }
}

{
  "mcpServers": {
    "helm": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/kubedoll-heavy-industries/mcp-helm", "--transport=stdio"]
    }
  }
}

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "docker",
          "args": ["run", "--rm", "-i", "ghcr.io/kubedoll-heavy-industries/mcp-helm", "--transport=stdio"]
        }
      }
    ]
  }
}

{
  "mcpServers": {
    "helm": {
      "command": "mcp-helm"
    }
  }
}

利用可能なツール

OCI レジストリ（oci://...）は参照に対応していません。OCI では、まずチャート名を把握したうえで、その名前を指定して get_versions または get_values を直接呼び出す必要があります。

インストール

Docker（推奨 — インストール不要。上記の「エディターの設定」で使用）：

docker pull ghcr.io/kubedoll-heavy-industries/mcp-helm:latest

バイナリ：

curl -fsSL https://github.com/kubedoll-heavy-industries/helm-mcp/releases/latest/download/mcp-helm_$(uname -s)_$(uname -m).tar.gz | tar xz
sudo mv mcp-helm /usr/local/bin/

Go：

go install github.com/kubedoll-heavy-industries/helm-mcp/cmd/mcp-helm@latest

セルフホスト

共有環境へのデプロイや HTTP エンドポイントが必要な場合：

docker run -p 8012:8012 ghcr.io/kubedoll-heavy-industries/mcp-helm:latest \
  --transport=http --listen=:8012
# Connect to http://localhost:8012/mcp

ヘルスエンドポイントと本番環境向けの推奨事項については、docs/self-hosting.md を参照してください。

ドキュメント

• 設定リファレンス — CLI フラグ、環境変数、トランスポートモード
• セルフホスティングガイド — Docker HTTP、ヘルスエンドポイント、本番環境向けのヒント
• トラブルシューティング — よくある問題と解決方法
• コントリビューション — 開発環境のセットアップ、テスト、PR のガイドライン
• セキュリティポリシー — 脆弱性の報告

ライセンス

MIT — LICENSE を参照してください。