KubernetesでMCPサーバーを動かす3つの方法:素のDeployment・ToolHive・kmcpを比較【Gateway API対応・2026年版】
KubernetesでMCPサーバーを動かす3つの方法(素のDeployment+stdioブリッジ、ToolHive operator、kmcp)をYAML付きで比較。stdioが1レプリカに制限される理由、ingress-nginx引退後のGateway APIでのタイムアウト設定、既定で無効な認証、チェックリストとFAQまで解説します。
最終更新:2026年11月13日 / 対象:ToolHive operator v0.59.0(2026年10月28日)、kmcp v0.4.0、Gateway API v1.6.2、MCP仕様 2026-07-28
結論(30秒で読める要約)
- KubernetesでのMCP Hostingとは、MCPサーバーをPodとして動かし、ServiceとGatewayを通してStreamable HTTPでClaude・Cursor・自作エージェントから使えるようにすることです。
- 2026年時点の現実的な方法は3つです。stdioをHTTPに変換するブリッジを入れた「素のDeployment」、ToolHive operator(
toolhive.stacklok.dev/v1beta1のMCPServer)、kmcp(kagent.dev/v1alpha1のMCPServer)です。 - サーバーが1〜2個で細かく制御したいなら素のDeployment、多数のサーバーを認証・ツール制限・シークレット込みでCRD管理したいならToolHive、kagentを使っている・npmやPyPIのサーバーをすぐ載せたいならkmcpが向いています。
- stdioのサーバーは1つのプロセスなので、Webアプリのようには増やせません。ToolHiveはstdioのバックエンドで
backendReplicasを2以上にすると拒否し、同時に接続できるクライアントは1つだと明記しています。 - コミュニティ版のingress-nginxは2026年3月に引退しました。新しく公開するならGateway APIを使い、
HTTPRouteのタイムアウトは必ず明示します。既定値は実装ごとに違い、長いツール呼び出しやSSEのストリームが真っ先に切られます。 - どちらのoperatorも認証は既定で無効です。ToolHiveのプロキシは、OIDCなどの参照を設定するまで、届いたリクエストをすべて受け付けます。
目次
- KubernetesでのMCP Hostingとは
- 3つの方法の比較
- 方法A:素のDeploymentとstdioブリッジ
- 方法B:ToolHive operator
- 方法C:kmcp
- Gateway APIでクラスタ外に公開する
- レプリカ・セッション・リソース制限
- MCPのためにKubernetesを使う価値はあるか
- 公開前チェックリスト
- よくあるハマりどころ
- NodeFlareならこう解決できる
- FAQ
1. KubernetesでのMCP Hostingとは
KubernetesでのMCP Hostingとは、Model Context Protocol(MCP)のサーバーをKubernetesクラスタ上のコンテナとして動かし、MCPクライアントから届くリモートのStreamable HTTPエンドポイントとして公開することです。GitHubにあるMCPサーバーの多くはstdioでしか通信できないため、「標準入出力をHTTPに変換する何か」が必要になる点は、他のホスティング先と同じです。Kubernetesでは、それを自分でコンテナに入れるか、コントローラーに任せるかを選びます。
それ以外はいつものKubernetesです。Deployment、Service、Gatewayからのルート、Secret、リソース制限を用意します。MCPならではの注意点は、接続が長く続くストリームになりうること、ツール呼び出しが数分かかることがあること、stdioのプロセスがクライアントごとの状態をメモリに持つことの3つです。
2. 3つの方法の比較
| 素のDeployment+ブリッジ | ToolHive operator | kmcp | |
|---|---|---|---|
| 提供元 | 自分 | Stacklok(OSS) | kagentプロジェクト(OSS) |
| リソース | Deployment + Service |
MCPServer(toolhive.stacklok.dev/v1beta1) |
MCPServer(kagent.dev/v1alpha1) |
| 確認した最新版 | なし | v0.59.0(2026年10月28日) | v0.4.0 |
| 導入 | 追加なし | Helmチャート2つ(CRDとoperator) | CRDのHelmチャート+ kmcp install |
| stdioサーバー | supergatewayなどのブリッジ経由 | プロキシのPodがサーバーPodの標準入出力にアタッチ | transportType: stdio でHTTP公開 |
| 既定のエンドポイント | 自分で決める | mcp-<name>-proxy:8080/mcp |
ポート 3000、/mcp |
| 認証 | Gatewayかアプリ側 | 既定は無効。OIDCなどを参照で設定 | agentgatewayなどを別途用意 |
| ツールの許可リスト | なし | tools フィールド、toolConfigRef |
なし |
| stdioのスケール | 1Podに1プロセス | バックエンドは1レプリカまで | 水平スケールの記載なし |
| 向いている用途 | 1〜3個、全部自分で制御 | 多数のサーバー、基盤チーム | kagent利用者、npm・PyPIをすぐ載せたい |
決め手になるのは、たいてい「何個のサーバーを動かすか」です。2個なら手書きのYAMLで十分ですが、20個になると、ブリッジ・シークレット・認証の配線をCRDにまとめられる効果が大きくなります。
3. 方法A:素のDeploymentとstdioブリッジ
素の方法では、stdioのサーバーとブリッジを同じコンテナで動かします。次の例では supergateway が @modelcontextprotocol/server-everything を包み、ポート8000でStreamable HTTPを提供します。イメージを自作する場合は MCPサーバーのDockerfileガイド を参照してください。
apiVersion: apps/v1
kind: Deployment
metadata:
name: mcp-everything
spec:
replicas: 1
selector:
matchLabels: {app: mcp-everything}
template:
metadata:
labels: {app: mcp-everything}
spec:
containers:
- name: mcp
image: node:22-alpine
command: ["npx", "-y", "supergateway",
"--stdio", "npx -y @modelcontextprotocol/server-everything",
"--outputTransport", "streamableHttp",
"--port", "8000"]
ports:
- containerPort: 8000
readinessProbe:
tcpSocket: {port: 8000}
periodSeconds: 5
resources:
requests: {cpu: 50m, memory: 256Mi}
limits: {memory: 512Mi}
---
apiVersion: v1
kind: Service
metadata:
name: mcp-everything
spec:
selector: {app: mcp-everything}
ports:
- port: 8000
targetPort: 8000
本番の前に、次の3つは必ず変えます。
- 起動時に
npxでダウンロードしない。Podが起動するたびにパッケージを取りに行くと、ロールアウトが遅くなり、レジストリが遅いと失敗します。サーバーとブリッジはイメージに含めておきます。 - ブリッジとサーバーのパッケージのバージョンを固定する。
- APIキーなどは
Secretに入れ、env.valueFrom.secretKeyRefで渡す。コマンドライン引数には書かない。
Gatewayを足す前に、手元から動作を確認します。
kubectl port-forward svc/mcp-everything 8000:8000
npx @modelcontextprotocol/inspector --cli http://localhost:8000/mcp --transport http --method tools/list
4. 方法B:ToolHive operator
ToolHive operatorは、MCPサーバーを MCPServer というカスタムリソースで管理します。stdioのサーバーの場合、operatorはプロキシのDeploymentとServiceを作ります。プロキシがサーバーのPodを起動してその標準入出力にアタッチするので、クライアントはプロキシとHTTPで話すだけで済みます。
CRDとoperatorを入れます(公式クイックスタートのコマンド)。
helm upgrade --install toolhive-operator-crds oci://ghcr.io/stacklok/toolhive/toolhive-operator-crds
helm upgrade --install toolhive-operator oci://ghcr.io/stacklok/toolhive/toolhive-operator \
-n toolhive-system --create-namespace
kubectl get pods -n toolhive-system
シークレットとツールの許可リストを付けたstdioサーバーの例です。
apiVersion: toolhive.stacklok.dev/v1beta1
kind: MCPServer
metadata:
name: github
namespace: toolhive-system
spec:
image: ghcr.io/github/github-mcp-server
transport: stdio
proxyPort: 8080
secrets:
- name: github-token
key: token
targetEnvName: GITHUB_PERSONAL_ACCESS_TOKEN
tools: ["get_issue", "list_issues", "search_issues"]
resources:
requests: {cpu: 50m, memory: 128Mi}
limits: {cpu: 500m, memory: 512Mi}
接続はクイックスタートと同じ手順です。
kubectl get mcpservers -n toolhive-system
kubectl port-forward service/mcp-github-proxy -n toolhive-system 8080:8080
curl -s http://localhost:8080/health
# MCPのエンドポイント: http://localhost:8080/mcp
採用前に知っておきたい点です。
- 認証は既定で無効です。公式ドキュメントによると、
oidcConfigRefかauthServerRefを設定しない限り、プロキシは届いたリクエストをすべて受け付けます。認証を設定するまでServiceはクラスタ内に閉じておきます。 - stdioはバックエンド1つです。ドキュメントには「stdioのMCPサーバーが同時に扱えるクライアント接続は1つ」とあり、stdioで
backendReplicasを2以上にすると拒否されます。プロキシ側(replicas)は増やせますが、2以上にするとRedisのセッションストレージが必須です。 permissionProfileは非推奨で無視されます。古いブログ記事にはまだ出てきますが、今は設定するとPermissionProfileUnsupportedの警告が出るだけです。- リリースが速いです。2026年10月19日から28日の間に v0.55.0〜v0.59.0 が出ています。チャートのバージョンを固定し、更新前にリリースノートを読みます。
5. 方法C:kmcp
kmcpは、kagentプロジェクトが提供するMCP用のコントローラーとCLIです。MCPServer リソースにコマンド・イメージ・ポートを書くと、コントローラーがStreamable HTTPで話すDeploymentとServiceを作ります。
CLI、CRD、コントローラーを入れます。
curl -fsSL https://raw.githubusercontent.com/kagent-dev/kmcp/refs/heads/main/scripts/get-kmcp.sh | bash
helm install kmcp-crds oci://ghcr.io/kagent-dev/kmcp/helm/kmcp-crds \
--namespace kmcp-system --create-namespace
kmcp install
npmで公開されているサーバーなら、YAMLを書かずにデプロイできます。
kmcp deploy package --deployment-name my-mcp-server \
--manager npx --args @modelcontextprotocol/server-everything
これで次のような MCPServer が作られます。
apiVersion: kagent.dev/v1alpha1
kind: MCPServer
metadata:
name: my-mcp-server
spec:
deployment:
cmd: npx
args: ["@modelcontextprotocol/server-everything"]
port: 3000
transportType: stdio
stdioTransport: {}
kubectl port-forward deploy/my-mcp-server 3000 を実行すると、http://127.0.0.1:3000/mcp で接続できます。kmcp v0.2.6のリリースノートには、サイドカーのゲートウェイがセッションごとに新しいstdioプロセスを起動すると書かれています。ToolHiveの「同時に1クライアント」の制約はない代わりに、セッションごとにメモリを使います。まだ v1alpha1 なので、リリース間でフィールドが変わる前提で使います。
6. Gateway APIでクラスタ外に公開する
新しく公開するなら、ingress-nginxではなくGateway APIを使います。Kubernetesプロジェクトは2026年3月にコミュニティ版のingress-nginxを引退させ、以後はリリースもバグ修正もセキュリティ修正も出ません。既存の環境は動き続けますが、新しく見つかった脆弱性は放置されます。
方法Aのサーバー向けの HTTPRoute です。タイムアウトを明示しています。
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
name: mcp-everything
spec:
parentRefs:
- name: public-gateway
hostnames: ["mcp.example.com"]
rules:
- matches:
- path: {type: PathPrefix, value: /mcp}
timeouts:
request: 600s
backendRequest: 600s
backendRefs:
- name: mcp-everything
port: 8000
MCPで効いてくるタイムアウトの設定です。
| フィールド | 意味 | MCPでの目安 |
|---|---|---|
timeouts.request |
クライアントからレスポンスまでの全体 | 最も長いツール呼び出し以上。0s で無効 |
timeouts.backendRequest |
Gatewayからバックエンドへの1回の試行 | request を超えてはいけない |
| 未設定 | 実装ごとの既定値 | 当てにしない。たとえばEnvoy自体のルートの既定タイムアウトは15秒 |
timeouts はExtendedサポートの機能なので、使っているGatewayが HTTPRouteRequestTimeout の適合テストに通っているか確認します。また、Gateway独自のポリシーリソースにあるアイドル・ストリームのタイムアウトも確認します。しばらく何も送らないSSEのストリームは、リクエストのタイムアウトを長くしても切られることがあります。
ルートを公開する前に、Gatewayかmcp側で認証を入れます。認証が無効のoperatorのプロキシに公開ホスト名を向けると、誰でもツールを呼べるエンドポイントになります。
7. レプリカ・セッション・リソース制限
KubernetesでMCPを増やすときの制約は、CPUではなく状態です。stdioのサーバーはクライアントごとの状態を1つのプロセスに持つので、ラウンドロビンのServiceの後ろに2台目を置くと、知らないセッションのリクエストが届きます。
| サーバーの種類 | レプリカを増やせるか | 必要なもの |
|---|---|---|
| ブリッジ経由のstdio | セッション固定か、セッションごとのプロセスがあれば可 | スティッキーな振り分け、またはkmcp方式 |
| ToolHiveのstdioバックエンド | 不可(1台まで) | バックエンドではなくプロキシを増やす |
| ステートレスなStreamable HTTP | 可 | 通常の負荷分散 |
旧来の Mcp-Session-Id セッションを使うStreamable HTTP |
振り分け固定か共有ストレージがあれば可 | スティッキーな振り分けかRedis |
Gateway APIのセッション維持(GEP-1619)はまだExperimentalで、設定場所も Backend リソースに移っているため、今は頼らないほうが安全です。Serviceの sessionAffinity: ClientIP はkube-proxyを通る通信にしか効かず、PodのエンドポイントへGatewayが直接振り分ける実装も多くあります。確実なのはステートレスなサーバーにすることです。パターンは MCPサーバーを複数レプリカでスケールする方法 にまとめています。
リソースについては、すべてのMCPのPodにメモリ上限を設定します。Node.jsのブリッジと npx で起動したサーバーの組み合わせは数百MBになることが多く、OOMで落ちるとそのPodのセッションはすべて切れます。terminationGracePeriodSeconds は実行中のツール呼び出しが終わるだけの長さにします。ToolHiveの既定の接続ドレインは30秒です。
8. MCPのためにKubernetesを使う価値はあるか
すでにクラスタを運用していて、社内サービス・データベース・閉じたネットワークの近くでMCPサーバーを動かしたいなら、価値があります。MCPのためだけにクラスタを新しく立てる価値は、ほとんどありません。
| 状況 | 向いているか |
|---|---|
| 既存クラスタがあり、クラスタ内のデータを使う | 向いている |
| 基盤チームが多数の社内チームに提供する | 向いている(ToolHive) |
| すでにkagentを使っている | 向いている(kmcp) |
| 個人や少人数で数個のサーバーを使う | たいてい不向き。コントロールプレーン・Gateway・ノードの費用が毎月かかる |
| 使っていないサーバーの費用をゼロにしたい | 標準では不可。ゼロスケールの仕組みを足さない限り、Podのrequestsは確保されたまま |
ホスティング先の全体比較は MCPサーバーのホスティング先ランキング を参照してください。
9. 公開前チェックリスト
- [ ] サーバーとブリッジをイメージに含め、バージョンを固定した(Pod起動時に
npxしない) - [ ] operatorとHelmチャートのバージョンを固定した
- [ ] シークレットはKubernetesの
Secretから渡している - [ ] すべてのMCPのPodにメモリ上限がある
- [ ] stdioのバックエンドは1レプリカか、セッションを固定している
- [ ]
HTTPRouteでtimeouts.requestを明示した - [ ] GatewayのアイドルやストリームのタイムアウトがSSEに足りる長さになっている
- [ ] 公開ホスト名を作る前に認証を有効にした
- [ ] operatorが対応していれば、ツールの許可リストを設定した
- [ ] 公開URLに対して
tools/listと無害なtools/callが通った
10. よくあるハマりどころ
| 症状 | 原因 | 対処 |
|---|---|---|
| 起動中にPodが再起動を繰り返す | npx のダウンロードが遅くプローブが失敗する |
パッケージをイメージに含めるか、initialDelaySeconds を延ばす |
/mcp が 404 になる |
ルートのパスとブリッジのパスが合っていない | PathPrefix をサーバー側のパスに合わせる(3つの方法とも既定は /mcp) |
| ツール呼び出しがきりのいい秒数で切れる | Gatewayの既定タイムアウト | timeouts.request とGatewayのストリームタイムアウトを設定する |
| 2人目の利用者に「session not found」が出る | stdioのレプリカにリクエストが分散している | 1レプリカにする、振り分けを固定する、セッションごとにプロセスを分ける |
ToolHiveが MCPServer を受け付けない |
transport: stdio で backendReplicas を2以上にした |
代わりにプロキシの replicas を増やす |
PermissionProfileUnsupported の警告が出る |
古い記事の非推奨フィールドを使っている | permissionProfile を削除する |
負荷をかけると OOMKilled になる |
メモリ上限に対してセッションが多すぎる | 上限を上げるか、同時セッション数を制限する |
| 誰でもツールを呼べてしまう | operatorの認証の参照が未設定 | oidcConfigRef か authServerRef を設定するか、Gatewayで認証する |
11. NodeFlareならこう解決できる
クラスタをまだ持っていない場合、この記事で挙げた課題は、Kubernetesを使わずにNodeFlareで次のように解決できます。
| Kubernetesでの課題 | NodeFlareでの解決策 |
|---|---|
| サーバーごとにstdioブリッジやoperatorを設定する手間 | GitHubのリポジトリを選ぶだけで、Dockerfileもコードの変更も不要でデプロイできます。stdioアダプターが /mcp でStreamable HTTPと旧来のHTTP+SSE(2024-11-05)の両方に応答し、実際にMCPの initialize が往復できて初めてデプロイ成功と判定します |
| 認証が既定で無効 | mcp_* 形式のBearer APIキーかOAuth 2.0が自動で付きます。権限は tools:call:get_weather のようにツール単位まで絞れ、拒否された呼び出しはサーバーに届きません |
| Gateway・TLS・タイムアウトの設定 | サーバーごとに https://<your-server>.nodeflare.tech/mcp のURLが発行されます。Pro以上ではカスタムドメインも使え、CNAMEで確認したうえでTLS証明書を自動発行します |
| stdioのサーバーを増やせない | 同時実行数が増えるとレプリカのVMを自動で追加します。アイドルなサーバーはスナップショットから1秒未満で復元します。Pro以上のAlways-Onなら1台を常に起動しておけます |
| 確保したPodの費用が毎月かかる | 停止中は0円です。コンピュートは1 GB時間あたり5円で、CPUと外向き通信の費用を含みます |
| Podの分離と外向き通信 | サーバーごとに独立したFirecrackerのmicroVMで動きます。外向き通信は off・observe・enforce の3モードで、最大100件の許可リストを設定できます |
| メモリ上限を勘で決める | 256 MB・512 MB・1 GB・2 GBから選べます。約1か月の利用をもとに、最も忙しい週から適切なサイズを提案し、OOMが起きれば自動で元に戻します |
| 呼び出しごとの状況が見えない | リクエストログにメソッド、ツール名、引数のキー(値は記録しない)、ステータス、結果、duration_ms が残ります。保存期間はFreeで7日、ProとTeamで30日です |
Freeは0円で、サーバー1つと月30 GB時間のコンピュートを使えます。Proは月2,980円でサーバー数は無制限、300 GB時間と10 GBのストレージが含まれます。
最小の始め方:
- GitHubでログインし、MCPサーバーのリポジトリを選ぶ(モノレポのサブディレクトリでも可)。
- デプロイし、APIキーが必要なサーバーなら環境変数を追加する。
- 発行されたURLとAPIキーを、Claude・Cursor・自作エージェントに設定する。
1サーバーまでは無料で試せます。nodeflare.tech からどうぞ。
12. FAQ
KubernetesでMCPサーバーは動かせますか?
動かせます。Podとして起動し、Serviceで公開し、Gatewayからルートを張ります。stdioにしか対応していないサーバーは、supergatewayのようなブリッジを入れるか、ToolHiveやkmcpのようにブリッジを自動で入れてくれるoperatorを使います。
ToolHive operatorとは何ですか?
Stacklokが開発しているオープンソースのKubernetes operatorで、MCPサーバーを MCPServer というカスタムリソースで管理します。stdio・SSE・Streamable HTTPのサーバーをプロキシ経由でHTTP公開し、シークレット、ツールの絞り込み、認証の参照を設定できます。執筆時点の最新版はv0.59.0です。
ToolHiveとkmcpの違いは?
どちらも MCPServer のCRDを持ち、stdioのサーバーをHTTPで公開します。ToolHive(v1beta1)は、認証・ツールの許可リスト・レジストリを含めて多数のサーバーを運用することに重点があります。kmcp(v1alpha1)はkagent由来で、サーバーの雛形作成・ビルド・デプロイを行うCLIがあり、kmcp deploy package でnpmやPyPIのパッケージをそのまま載せられます。
stdioのMCPサーバーをKubernetesで複数レプリカにできますか?
そのままではできません。stdioのプロセスはクライアントごとの状態をメモリに持つため、ToolHiveはstdioのバックエンドを1レプリカに制限しています。多くのクライアントに対応するには、セッションごとにプロセスを分けるか、振り分けを固定するか、ステートレスなStreamable HTTPのサーバーにします。
MCPの公開にはingress-nginxとGateway APIのどちらを使うべきですか?
Gateway APIを使います。コミュニティ版のingress-nginxは2026年3月に引退し、セキュリティ修正が出なくなりました。HTTPRoute の既定タイムアウトは実装ごとに違うので、明示的に設定します。
KubernetesでMCPのツール呼び出しがタイムアウトするのはなぜですか?
多くの場合、Gatewayの既定のリクエストタイムアウトやストリームのタイムアウトで、ツールの処理が終わる前に切られています。HTTPRoute の timeouts.request を最も長いツール呼び出し以上にし、Gateway側のアイドル・ストリームのタイムアウトも延ばします。
ToolHive operatorは認証を自動で有効にしますか?
しません。oidcConfigRef か authServerRef を設定しない限り、プロキシは届いたリクエストをすべて受け付けます。認証を設定するまで、Serviceはクラスタ内に閉じておきます。
Kubernetes上のMCPサーバーにClaudeやCursorから接続するには?
クライアントの設定で、/mcp で終わる公開HTTPSのURLをリモート(Streamable HTTP)のサーバーとして追加します。Gatewayで認証している場合は Authorization ヘッダーも付けます。ローカルで試すだけなら、kubectl port-forward して http://localhost:<port>/mcp を指定します。
KubernetesはマネージドのMCP Hostingより安いですか?
すでにクラスタの費用を払っている場合に限ります。新しく立てたクラスタは、ツールが一度も呼ばれなくてもコントロールプレーン・Gateway・ノードの費用が毎時間かかります。ゼロスケールのあるマネージドのMCP Hostingなら、使っていないサーバーの費用はほとんどかかりません。
まとめ
- すでにクラスタがあり、サーバーがクラスタ内のリソースを使うなら、KubernetesはMCP Hostingの良い選択肢です。
- 数個なら素のDeploymentとブリッジ、多数を認証・ツール制限込みで運用するならToolHive、kagentを使っているならkmcpが向いています。
- stdioのサーバーは1プロセスです。Webアプリと同じ感覚で増やさないようにします。
- 公開はGateway APIで行い、タイムアウトを明示し、ルートを公開する前に認証を有効にします。
参考資料
- ToolHive Kubernetes operator クイックスタート(Stacklok)
- Run MCP servers in Kubernetes(ToolHiveドキュメント)
- ToolHive operator README(GitHub)
- kmcp:MCPサーバーのデプロイ(kagentドキュメント)
- kmcp クイックスタート(kagentドキュメント)
- Gateway API HTTPRoute
- GEP-1742:HTTPRouteのタイムアウト
- GEP-1619:セッション維持
- Ingress NGINX Retirement: What You Need to Know(Kubernetesブログ)
- supergateway(GitHub)
