autogen-kubernete-mcp

autogen-kubernetes-mcp is an MCP(Model Context Protocol) server that acts as a Python code interpreter fully compatible with the python built-in tool of the gpt-oss model.

It is designed as a custom extension for autogen-kubernetes, enabling Python code execution inside a Kubernetes Pod with configurable runtime parameters.

This MCP server can be used in environments where code execution needs to be isolated, reproducible, and integrated with Kubernetes workloads.

Installation & Usage

1. Install via pip

pip install autogen-kubernetes-mcp

2. Install via uv

uv pip install autogen-kubernetes-mcp

3. Run via uvx

uvx autogen-kubernetes-mcp commandline --namespace my-namespace --image python:3.11-slim

4. Run via Python module

python -m autogen_kubernetes_mcp commandline --namespace my-namespace --image python:3.11-slim

Command-line Arguments

Command-line arguments are used when creating PodCommandLineCodeExecutor/PodJupyterCodeExecutor and MCP server.

type arguments: jupyter type creates PodJupyterCodeExecutor for python code executor tool.

MCP server have to run in same kubernetes cluster because PodJupyterCodeExecutor only uses service FQDN to connect jupyter server.

Not validated for non-text outputs yet.

flowchart LR
  subgraph K8sCluster["Kubernetes Cluster"]
    E[PodJupyterCodeExecutor]
    J[JupyterServerPod]
  end

  E --generate--> J

All the arguments are optional

License

This project is licensed under the MIT License.