Kubernetes Ephemeral Job
Runs a command in a throwaway Kubernetes pod and returns exit code, output and artifacts.
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.7.1
- Listing updated
- 4 days ago
About Kubernetes Ephemeral Job
Kubernetes Ephemeral Job is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add mcp-k8s-ephemeral-job --env MCP_K8S_ALLOWED_IMAGES='<MCP_K8S_ALLOWED_IMAGES>' --env MCP_K8S_CLONE_SECRET='<MCP_K8S_CLONE_SECRET>' --env MCP_K8S_AUTH_TOKEN='<MCP_K8S_AUTH_TOKEN>' -- docker run -i --rm -e MCP_K8S_ALLOWED_IMAGES -e MCP_K8S_CLONE_SECRET -e MCP_K8S_AUTH_TOKEN docker.io/idconstruct/mcp-k8s-ephemeral-job:v0.7.1Add to claude_desktop_config.json
{
"mcpServers": {
"mcp-k8s-ephemeral-job": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_K8S_ALLOWED_IMAGES",
"-e",
"MCP_K8S_CLONE_SECRET",
"-e",
"MCP_K8S_AUTH_TOKEN",
"docker.io/idconstruct/mcp-k8s-ephemeral-job:v0.7.1"
],
"env": {
"MCP_K8S_ALLOWED_IMAGES": "<MCP_K8S_ALLOWED_IMAGES>",
"MCP_K8S_CLONE_SECRET": "<MCP_K8S_CLONE_SECRET>",
"MCP_K8S_AUTH_TOKEN": "<MCP_K8S_AUTH_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-k8s-ephemeral-job": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_K8S_ALLOWED_IMAGES",
"-e",
"MCP_K8S_CLONE_SECRET",
"-e",
"MCP_K8S_AUTH_TOKEN",
"docker.io/idconstruct/mcp-k8s-ephemeral-job:v0.7.1"
],
"env": {
"MCP_K8S_ALLOWED_IMAGES": "<MCP_K8S_ALLOWED_IMAGES>",
"MCP_K8S_CLONE_SECRET": "<MCP_K8S_CLONE_SECRET>",
"MCP_K8S_AUTH_TOKEN": "<MCP_K8S_AUTH_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-k8s-ephemeral-job": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_K8S_ALLOWED_IMAGES",
"-e",
"MCP_K8S_CLONE_SECRET",
"-e",
"MCP_K8S_AUTH_TOKEN",
"docker.io/idconstruct/mcp-k8s-ephemeral-job:v0.7.1"
],
"env": {
"MCP_K8S_ALLOWED_IMAGES": "<MCP_K8S_ALLOWED_IMAGES>",
"MCP_K8S_CLONE_SECRET": "<MCP_K8S_CLONE_SECRET>",
"MCP_K8S_AUTH_TOKEN": "<MCP_K8S_AUTH_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-k8s-ephemeral-job": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_K8S_ALLOWED_IMAGES",
"-e",
"MCP_K8S_CLONE_SECRET",
"-e",
"MCP_K8S_AUTH_TOKEN",
"docker.io/idconstruct/mcp-k8s-ephemeral-job:v0.7.1"
],
"env": {
"MCP_K8S_ALLOWED_IMAGES": "<MCP_K8S_ALLOWED_IMAGES>",
"MCP_K8S_CLONE_SECRET": "<MCP_K8S_CLONE_SECRET>",
"MCP_K8S_AUTH_TOKEN": "<MCP_K8S_AUTH_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-k8s-ephemeral-job": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"MCP_K8S_ALLOWED_IMAGES",
"-e",
"MCP_K8S_CLONE_SECRET",
"-e",
"MCP_K8S_AUTH_TOKEN",
"docker.io/idconstruct/mcp-k8s-ephemeral-job:v0.7.1"
],
"env": {
"MCP_K8S_ALLOWED_IMAGES": "<MCP_K8S_ALLOWED_IMAGES>",
"MCP_K8S_CLONE_SECRET": "<MCP_K8S_CLONE_SECRET>",
"MCP_K8S_AUTH_TOKEN": "<MCP_K8S_AUTH_TOKEN>"
}
}
}
}Configuration
MCP_K8S_ALLOWED_IMAGESStrict image allowlist (CSV). Empty means every call is rejected, so this must be set.RequiredMCP_K8S_KUBECONFIGPath to the kubeconfig inside the container. Empty = use in-cluster credentials.MCP_K8S_NAMESPACENamespace the ephemeral pods are created in. Needs a Role/RoleBinding for jobs and pods.MCP_K8S_TRANSPORTMCP transport: stdio | http | sse. Must be 'stdio' for direct docker/stdio use.MCP_K8S_DEFAULT_TIMEOUT_SDefault wall-clock timeout per job, seconds.MCP_K8S_MAX_TIMEOUT_SMaximum wall-clock timeout a caller may request, seconds.MCP_K8S_MAX_OUTPUT_BYTESCap on combined stdout/stderr before truncation.MCP_K8S_MAX_ARTIFACT_BYTESCap on the total size of returned artifacts.MCP_K8S_MAX_CONCURRENTMaximum ephemeral pods running at the same time.MCP_K8S_DEFAULT_CPUPod CPU request; limits come from the caller or the namespace LimitRange.MCP_K8S_DEFAULT_MEMORYPod memory request; limits come from the caller or the namespace LimitRange.MCP_K8S_SIDECAR_IMAGEHelper image used to inject input files and collect artifacts.MCP_K8S_CLONE_IMAGEImage carrying git for the clone init container. Empty disables the clone field.MCP_K8S_CLONE_SECRETSecret with git tokens, mounted only on the cloner. Empty disables the clone field.MCP_K8S_CACHE_PVCExisting PVC mounted into every job pod as a shared cache. Empty = no cache.MCP_K8S_CACHE_MOUNT_PATHWhere the cache PVC is mounted, e.g. /go/pkg/mod. Empty = no cache.MCP_K8S_JOB_EXTRA_ENVJSON object of env vars added to every job pod; caller keys win on collision.MCP_K8S_AUTH_TOKENOptional X-MCP-AUTH token required on every request (http/sse transports only).
Pricing
Open source
Kubernetes Ephemeral Job FAQ
Is Kubernetes Ephemeral Job free?
Yes. Kubernetes Ephemeral Job is open source, so you can use and self-host it for free.
How do I add Kubernetes Ephemeral Job to Claude Code?
Run this command in your terminal: claude mcp add mcp-k8s-ephemeral-job --env MCP_K8S_ALLOWED_IMAGES='<MCP_K8S_ALLOWED_IMAGES>' --env MCP_K8S_CLONE_SECRET='<MCP_K8S_CLONE_SECRET>' --env MCP_K8S_AUTH_TOKEN='<MCP_K8S_AUTH_TOKEN>' -- docker run -i --rm -e MCP_K8S_ALLOWED_IMAGES -e MCP_K8S_CLONE_SECRET -e MCP_K8S_AUTH_TOKEN docker.io/idconstruct/mcp-k8s-ephemeral-job:v0.7.1
What are the best alternatives to Kubernetes Ephemeral Job?
The closest alternatives to Kubernetes Ephemeral Job are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Kubernetes Ephemeral Job

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools