ipybox

mcp-name: io.github.gradion-ai/ipybox

ipybox is a unified execution environment for Python code, shell commands, and programmatic MCP tool calls.

Overview

ipybox executes code blocks in a stateful IPython kernel. A code block can contain any combination of Python code, shell commands, and programmatic MCP tool calls. Kernels can be sandboxed with sandbox-runtime, enforcing filesystem and network restrictions at OS level.

It generates Python APIs for MCP server tools via mcpygen, and supports application-level approval of individual tool calls and shell commands during code execution. ipybox runs locally on your computer, enabling protected access to your local data and tools.

Documentation:

• 📚 Documentation
• 🏗️ Architecture
• 🤖 llms.txt
• 🤖 llms-full.txt

Capabilities

Usage

{
  "name": "ipybox",
  "version": "0.0.2",
  "description": "Code action plugins for Claude Code using ipybox",
  "owner": {
    "name": "gradion-ai"
  },
  "plugins": [
    {
      "name": "codeact-default",
      "source": "./plugin",
      "description": "Runs ipybox without sandbox-runtime ",
      "version": "0.0.2",
      "keywords": [
        "codeact",
        "python",
        "mcp",
        "ipybox"
      ],
      "mcpServers": {
        "ipybox": {
          "command": "uvx",
          "args": [
            "ipybox",
            "--workspace",
            "${PWD}"
          ]
        }
      }
    },
    {
      "name": "codeact-sandbox",
      "source": "./plugin",
      "description": "Runs ipybox with sandbox-runtime",
      "version": "0.0.2",
      "keywords": [
        "codeact",
        "python",
        "mcp",
        "ipybox",
        "sandbox"
      ],
      "mcpServers": {
        "ipybox": {
          "command": "uvx",
          "args": [
            "ipybox",
            "--workspace",
            "${PWD}",
            "--sandbox",
            "--sandbox-config",
            "sandbox-config.json"
          ]
        }
      }
    },
    {
      "name": "codeact-docker",
      "source": "./plugin",
      "description": "Runs ipybox as a Docker container",
      "version": "0.0.2",
      "keywords": [
        "codeact",
        "python",
        "mcp",
        "ipybox",
        "docker"
      ],
      "mcpServers": {
        "ipybox": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-v",
            "${PWD}:/app/workspace",
            "ipybox"
          ]
        }
      }
    }
  ]
}