K8s Port Forward MCP

Kubernetes Port Forward — MCP Server: port-forward Kubernetes services with terminal integration

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "k8s-port-forward-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "k8s-port-forward-mcp@latest"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (12)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by K8s Port Forward MCP.

namespace

Callable MCP tool function

services

Callable MCP tool function

serviceName

Callable MCP tool function

list_k8s_services

Callable MCP tool function

localPort

Callable MCP tool function

remotePort

Callable MCP tool function

Documentation Overview

Kubernetes Port Forward MCP

A Model Context Protocol (MCP) server that provides tools for discovering Kubernetes services and running kubectl port-forward sessions (optionally with separate log windows). It is designed for MCP clients/LLMs that translate natural language into structured tool calls.

Kubernetes Port Forward MCP vs `kubectl port-forward`

This package provides an MCP interface on top of the standard kubectl workflow.

kubectl: Best when you already know exact namespace/pod/ports and prefer manual control.
MCP: Best when an agent should discover services and run one or many port-forwards via tool calls.

Key Features

Service discovery: list namespaces and infer services (short name → environments → namespace) from running pods.
Multi-service in one session: start multiple port-forwards with one tool call.
LLM-friendly API: start_k8s_port_forward accepts an array so each service can use different namespace, environment, localPort, and remotePort.
Optional logs: open kubectl logs -f in a separate OS-level terminal window per service.

Requirements
Quick Start
Getting Started
Examples
Tools
Output and Logs
Configuration
Validation and Debugging

Requirements

Node.js 18 or newer
kubectl installed and configured with access to your cluster
VS Code, Cursor, Windsurf, Claude Desktop, Cline, or any other MCP client

Quick Start

Add this server to your MCP client (use the config in Getting Started below).
Ask your assistant: "List available Kubernetes services."
Ask your assistant: "Run api service on local port 3002."
Open the returned URL (for example http://localhost:3002).
When finished, ask: "Stop all port-forwards."

Getting Started

First, install the Kubernetes Port Forward MCP server with your client.

Standard config works in most MCP clients:

JSON Config

{
  "mcpServers": {
    "k8s-port-forward": {
      "command": "npx",
      "args": ["-y", "k8s-port-forward-mcp@latest"]
    }
  }
}

Amp

Add via the Amp VS Code extension settings screen or by updating your settings.json file:

json

"amp.mcpServers": {
  "k8s-port-forward": {
    "command": "npx",
    "args": [
      "-y",
      "k8s-port-forward-mcp@latest"
    ]
  }
}

Amp CLI Setup:

Add via the amp mcp add command below:

bash

amp mcp add k8s-port-forward -- npx -y k8s-port-forward-mcp@latest

Antigravity

Add via the Antigravity settings or by updating your configuration file:

config.json

{
  "mcpServers": {
    "k8s-port-forward": {
      "command": "npx",
      "args": ["-y", "k8s-port-forward-mcp@latest"]
    }
  }
}

Claude Code

Use the Claude Code CLI to add the Kubernetes Port Forward MCP server:

Terminal

claude mcp add k8s-port-forward npx -y k8s-port-forward-mcp@latest

Claude Desktop

Follow the MCP install guide, use the standard config above.

Cline

Follow the instruction in the section Configuring MCP Servers

Example: Local Setup

Add the following to your cline_mcp_settings.json file:

config.json

{
  "mcpServers": {
    "k8s-port-forward": {
      "type": "stdio",
      "command": "npx",
      "timeout": 30,
      "args": ["-y", "k8s-port-forward-mcp@latest"],
      "disabled": false
    }
  }
}

Codex

Use the Codex CLI to add the Kubernetes Port Forward MCP server:

bash

codex mcp add k8s-port-forward npx "-y" "k8s-port-forward-mcp@latest"

Alternatively, create or edit the configuration file ~/.codex/config.toml and add:

toml

[mcp_servers.k8s-port-forward]
command = "npx"
args = ["-y", "k8s-port-forward-mcp@latest"]

For more information, see the Codex MCP documentation.

Copilot

Use the Copilot CLI to interactively add the Kubernetes Port Forward MCP server:

bash

/mcp add

Alternatively, create or edit the configuration file ~/.copilot/mcp-config.json and add:

config.json

{
  "mcpServers": {
    "k8s-port-forward": {
      "type": "local",
      "command": "npx",
      "tools": ["*"],
      "args": ["-y", "k8s-port-forward-mcp@latest"]
    }
  }
}

For more information, see the Copilot CLI documentation.

Cursor

Click the button to install:

Or install manually:

Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command npx -y k8s-port-forward-mcp@latest. You can also verify config or add command arguments via clicking Edit.

Factory

Use the Factory CLI to add the Kubernetes Port Forward MCP server:

bash

droid mcp add k8s-port-forward "npx -y k8s-port-forward-mcp@latest"

Alternatively, type /mcp within Factory droid to open an interactive UI for managing MCP servers.

For more information, see the Factory MCP documentation.

Gemini CLI

Follow the MCP install guide, use the standard config above.

Goose

Click the button to install:

Or install manually:

Go to Advanced settings -> Extensions -> Add custom extension. Name to your liking, use type STDIO, and set the command to npx -y k8s-port-forward-mcp@latest. Click "Add Extension".

Kiro

Follow the MCP Servers documentation. For example in .kiro/settings/mcp.json:

config.json

{
  "mcpServers": {
    "k8s-port-forward": {
      "command": "npx",
      "args": ["-y", "k8s-port-forward-mcp@latest"]
    }
  }
}

LM Studio

Click the button to install:

Or install manually:

Go to Program in the right sidebar -> Install -> Edit mcp.json. Use the standard config above.

opencode

Follow the MCP Servers documentation. For example in ~/.config/opencode/opencode.json:

config.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "k8s-port-forward": {
      "type": "local",
      "command": ["npx", "-y", "k8s-port-forward-mcp@latest"],
      "enabled": true
    }
  }
}

Qodo Gen

Open Qodo Gen chat panel in VSCode or IntelliJ -> Connect more tools -> + Add new MCP -> Paste the standard config above.

Click Save.

VS Code

Click the button to install:

Or install manually:

Read the full README →View source on GitHub →

Related MCP Servers

View all in Cloud Platforms View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads

180

Package downloads in the last 30 days.

Last commit

5mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about K8s Port Forward MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "k8s-port-forward-mcp": { "command": "npx", "args": ["-y","k8s-port-forward-mcp@latest"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

K8s Port Forward MCP AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/k8s-port-forward-mcp?style=directory)](https://allmcps.com/mcp/k8s-port-forward-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/k8s-port-forward-mcp"><img src="https://allmcps.com/api/badge/k8s-port-forward-mcp?style=directory" alt="K8s Port Forward MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryCloud Platforms

51Quality signal: Good · 51/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity3/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in ☁️ Cloud Platforms →Best MCP servers for Cloud Platforms →Alternatives to K8s Port Forward MCP →Install in Claude Desktop Install in Cursor Install in VS Code

K8s Port Forward MCP

Kubernetes Port Forward — MCP Server: port-forward Kubernetes services with terminal integration

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "k8s-port-forward-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "k8s-port-forward-mcp@latest"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Capabilities & Tool Schemas (12)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by K8s Port Forward MCP.

namespace

Callable MCP tool function

services

Callable MCP tool function

serviceName

Callable MCP tool function

list_k8s_services

Callable MCP tool function

localPort

Callable MCP tool function

remotePort

Callable MCP tool function

Documentation Overview

Kubernetes Port Forward MCP

Kubernetes Port Forward MCP vs `kubectl port-forward`

This package provides an MCP interface on top of the standard kubectl workflow.

kubectl: Best when you already know exact namespace/pod/ports and prefer manual control.
MCP: Best when an agent should discover services and run one or many port-forwards via tool calls.

Key Features

Service discovery: list namespaces and infer services (short name → environments → namespace) from running pods.
Multi-service in one session: start multiple port-forwards with one tool call.
LLM-friendly API: start_k8s_port_forward accepts an array so each service can use different namespace, environment, localPort, and remotePort.
Optional logs: open kubectl logs -f in a separate OS-level terminal window per service.

Requirements
Quick Start
Getting Started
Examples
Tools
Output and Logs
Configuration
Validation and Debugging

Requirements

Node.js 18 or newer
kubectl installed and configured with access to your cluster
VS Code, Cursor, Windsurf, Claude Desktop, Cline, or any other MCP client

Quick Start

Add this server to your MCP client (use the config in Getting Started below).
Ask your assistant: "List available Kubernetes services."
Ask your assistant: "Run api service on local port 3002."
Open the returned URL (for example http://localhost:3002).
When finished, ask: "Stop all port-forwards."

Getting Started

First, install the Kubernetes Port Forward MCP server with your client.

Standard config works in most MCP clients:

JSON Config

{
  "mcpServers": {
    "k8s-port-forward": {
      "command": "npx",
      "args": ["-y", "k8s-port-forward-mcp@latest"]
    }
  }
}

Amp

Add via the Amp VS Code extension settings screen or by updating your settings.json file:

json

"amp.mcpServers": {
  "k8s-port-forward": {
    "command": "npx",
    "args": [
      "-y",
      "k8s-port-forward-mcp@latest"
    ]
  }
}

Amp CLI Setup:

Add via the amp mcp add command below:

bash

amp mcp add k8s-port-forward -- npx -y k8s-port-forward-mcp@latest

Antigravity

Add via the Antigravity settings or by updating your configuration file:

config.json

{
  "mcpServers": {
    "k8s-port-forward": {
      "command": "npx",
      "args": ["-y", "k8s-port-forward-mcp@latest"]
    }
  }
}

Claude Code

Use the Claude Code CLI to add the Kubernetes Port Forward MCP server:

Terminal

claude mcp add k8s-port-forward npx -y k8s-port-forward-mcp@latest

Claude Desktop

Follow the MCP install guide, use the standard config above.

Cline

Follow the instruction in the section Configuring MCP Servers

Example: Local Setup

Add the following to your cline_mcp_settings.json file:

config.json

{
  "mcpServers": {
    "k8s-port-forward": {
      "type": "stdio",
      "command": "npx",
      "timeout": 30,
      "args": ["-y", "k8s-port-forward-mcp@latest"],
      "disabled": false
    }
  }
}

Codex

Use the Codex CLI to add the Kubernetes Port Forward MCP server:

bash

codex mcp add k8s-port-forward npx "-y" "k8s-port-forward-mcp@latest"

Alternatively, create or edit the configuration file ~/.codex/config.toml and add:

toml

[mcp_servers.k8s-port-forward]
command = "npx"
args = ["-y", "k8s-port-forward-mcp@latest"]

For more information, see the Codex MCP documentation.

Copilot

Use the Copilot CLI to interactively add the Kubernetes Port Forward MCP server:

bash

/mcp add

Alternatively, create or edit the configuration file ~/.copilot/mcp-config.json and add:

config.json

{
  "mcpServers": {
    "k8s-port-forward": {
      "type": "local",
      "command": "npx",
      "tools": ["*"],
      "args": ["-y", "k8s-port-forward-mcp@latest"]
    }
  }
}

For more information, see the Copilot CLI documentation.

Cursor

Click the button to install:

Or install manually:

Factory

Use the Factory CLI to add the Kubernetes Port Forward MCP server:

bash

droid mcp add k8s-port-forward "npx -y k8s-port-forward-mcp@latest"

Alternatively, type /mcp within Factory droid to open an interactive UI for managing MCP servers.

For more information, see the Factory MCP documentation.

Gemini CLI

Follow the MCP install guide, use the standard config above.

Goose

Click the button to install:

Or install manually:

Go to Advanced settings -> Extensions -> Add custom extension. Name to your liking, use type STDIO, and set the command to npx -y k8s-port-forward-mcp@latest. Click "Add Extension".

Kiro

Follow the MCP Servers documentation. For example in .kiro/settings/mcp.json:

config.json

{
  "mcpServers": {
    "k8s-port-forward": {
      "command": "npx",
      "args": ["-y", "k8s-port-forward-mcp@latest"]
    }
  }
}

LM Studio

Click the button to install:

Or install manually:

Go to Program in the right sidebar -> Install -> Edit mcp.json. Use the standard config above.

opencode

Follow the MCP Servers documentation. For example in ~/.config/opencode/opencode.json:

config.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "k8s-port-forward": {
      "type": "local",
      "command": ["npx", "-y", "k8s-port-forward-mcp@latest"],
      "enabled": true
    }
  }
}

Qodo Gen

Open Qodo Gen chat panel in VSCode or IntelliJ -> Connect more tools -> + Add new MCP -> Paste the standard config above.

Click Save.

VS Code

Click the button to install:

Or install manually:

Read the full README →View source on GitHub →

Related MCP Servers

View all in Cloud Platforms View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads

180

Package downloads in the last 30 days.

Last commit

5mo ago

Most recent push to the default branch.

Tools exposed

Callable tools this server registers over MCP.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about K8s Port Forward MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "k8s-port-forward-mcp": { "command": "npx", "args": ["-y","k8s-port-forward-mcp@latest"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/k8s-port-forward-mcp?style=directory)](https://allmcps.com/mcp/k8s-port-forward-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/k8s-port-forward-mcp"><img src="https://allmcps.com/api/badge/k8s-port-forward-mcp?style=directory" alt="K8s Port Forward MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryCloud Platforms

51Quality signal: Good · 51/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity3/15

Community engagement0/10

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in ☁️ Cloud Platforms →Best MCP servers for Cloud Platforms →Alternatives to K8s Port Forward MCP →Install in Claude Desktop Install in Cursor Install in VS Code

K8s Port Forward MCP

Quick Install

Client Config & Setup

Documentation Overview

Kubernetes Port Forward MCP

Kubernetes Port Forward MCP vs kubectl port-forward

Key Features

Table of Contents

Requirements

Quick Start

Getting Started

Click the button to install:

Or install manually:

Click the button to install:

Or install manually:

Click the button to install:

Or install manually:

Click the button to install:

Or install manually:

Related MCP Servers

Adoption & maintenance

Reviews

Frequently Asked Questions about K8s Port Forward MCP

AllMCPs Directory Badge

Technical Specs & Signals

AllMCPs Server

Own this project?

Share & Embed

Explore more

K8s Port Forward MCP

Quick Install

Client Config & Setup

Documentation Overview

Kubernetes Port Forward MCP

Kubernetes Port Forward MCP vs kubectl port-forward

Key Features

Table of Contents

Requirements

Quick Start

Getting Started

Click the button to install:

Or install manually:

Click the button to install:

Or install manually:

Click the button to install:

Or install manually:

Click the button to install:

Or install manually:

Related MCP Servers

Adoption & maintenance

Reviews

Frequently Asked Questions about K8s Port Forward MCP

AllMCPs Directory Badge

Technical Specs & Signals

AllMCPs Server

Own this project?

Share & Embed

Explore more

Kubernetes Port Forward MCP vs `kubectl port-forward`

Kubernetes Port Forward MCP vs `kubectl port-forward`