Kubernetes Port Forward – Mcp Server

MCP server that provides tools for managing Kubernetes port-forwarding sessions.

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

Kubernetes Port Forward MCP vskubectl port-forward

This package provides anMCP interfaceon top of the standardkubectlworkflow.

- 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.

- 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_forwardaccepts an array so each service can use differentnamespace,environment,localPort, andremotePort.
- Optional logs: openkubectl logs -fin a separate OS-level terminal window per service.

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

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

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

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

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

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

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

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

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

Follow the MCP installguide, use the standard config above.

Follow the instruction in the sectionConfiguring MCP Servers

Add the following to yourcline_mcp_settings.jsonfile:

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

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

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

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

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

For more information, see theCodex MCP documentation.

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

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

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

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

# For VS Code code --add-mcp '{"name":"k8s-port-forward","command":"npx","args":["-y","k8s-port-forward-mcp@latest"]}'

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

User:"Run the frontend service in qa on port 3001"*
- Calllist_k8s_services({})to find the exact service name.
- Receive list containing e.g.frontend: qa (ns: ...), dev (ns: ...).
- Callstart_k8s_port_forward({ services: [{ serviceName: "frontend", environment: "qa", localPort: 3001 }] }).
- Result: port-forwards run in the MCP server process; ifincludeLogsis true, logs open in a separate window. The tool result includeshttp://localhost:3001and the exact kubectl commands.

- Title: List namespaces
- Description: List all available Kubernetes namespaces.
- Parameters: None
- Read-only:true

- Title: List services
- Description: List available services grouped by short name and environment.
- Parameters:

- namespace(string, optional): Filter results to a namespace.

- Title: Start port-forward
- Description: Start port-forwarding for one or more services.
- Parameters:

- services(array, required): List of service configs.

- serviceName(string, required): Short name of the service. (Calllist_k8s_servicesfirst.)
- localPort(number, required): Local port to bind (1-65535).
- namespace(string, optional): Namespace to target.
- remotePort(number, optional): Remote (cluster) port.
- environment(string, optional):dev|qa|stg|prod.
- includeLogs(boolean, optional): Whether to open logs in a separate window (default: true).

- Title: Stop port-forward
- Description: Stop all active port-forward processes started by this MCP server.
- Parameters: None
- Read-only:false

Since the MCP server spawns actualkubectlprocesses in the background, you may want to verify what's running and see the exact commands being executed.

# List all kubectl processes tasklist /fi "imagename eq kubectl.exe" # See the exact commands with process IDs Get-CimInstance Win32_Process -Filter "Name='kubectl.exe'" | Select-Object ProcessId,CommandLine

# List all kubectl processes ps aux | grep kubectl # See the exact commands with process IDs ps -ef | grep kubectl

- Verify port-forwards are actually running
- See the exact namespaces and ports being used
- Identify stuck processes that might need manual termination
- Debug connectivity issues by examining the actual commands

- Port already in use: choose another local port or stop the conflicting process.
- Connection refused: verify service name, namespace, and selected environment.
- No logs window: setincludeLogs: truein the port-forward request.
- Stuck process: terminate by PID (taskkill /PID <pid>on Windows,kill <pid>on Linux/macOS).

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Run and interpret Kubernetes commands interactively with a provided kubeconfig.

Tilt MCP is a Model Context Protocol server that integrates with Tilt to provide programmatic access to Tilt resources, logs, and management operations for Kubernetes development environments

All Azure MCP tools in a single server. The Azure MCP Server implements the MCP specification to create a seamless connection between AI agents and Azure services. Azure MCP Server can be used alone or with the GitHub Copilot for Azure extension in VS Code.

The Railway MCP Server enables natural language interaction with your Railway projects and infrastructure. Ask your IDE or AI assistant to create projects, deploy templates, manage environments, pull variables, redeploy services, and more.

The Shipyard CLI provides an MCP server for agents to manage Shipyard environments directly: by pulling logs, comparing branches, running tests, and stopping/starting environments..

Secure virtual machines for agents hosted by Superserve

A MCP server for managing Brev development environments using the Brev CLI.

Provides an offline AWS CDK API reference.