How do I install io.github.gradion-ai/ipybox?

Install io.github.gradion-ai/ipybox via the package manager from https://pypi.org, then add the server config to your MCP client (Claude Desktop, Cursor, or VS Code).

Is io.github.gradion-ai/ipybox open source?

Yes, io.github.gradion-ai/ipybox is open source under the Apache-2.0 license. Source code is available at https://github.com/gradion-ai/ipybox.

What category does io.github.gradion-ai/ipybox belong to?

io.github.gradion-ai/ipybox is listed under Databases MCP servers on MCPFind.

io.github.gradion-ai/ipybox — MCP Server for Databases

Q: What is io.github.gradion-ai/ipybox?

Unified execution environment for Python code, shell commands, and programmatic MCP tool calls

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.

[!NOTE] Next generation ipybox

This is the next generation of ipybox, a complete rewrite. Older versions are maintained on the 0.6.x branch and can be obtained with pip install ipybox<0.7.

Documentation:

Capabilities

Capability	Description
Stateful execution	State persists across executions in IPython kernels
Unified execution	Combine Python code, shell commands, and programmatic MCP tool calls in a code block
Shell command execution	Run shell commands via `!cmd` syntax, capture output into Python variables
Programmatic MCP tool calls	MCP tools called via generated Python API ("code mode"), not JSON directly
Python tool API generation	Typed functions and Pydantic models generated from MCP tool schemas via mcpygen
Application-level approval	Individual approval of tool calls and shell commands during code execution
Lightweight sandboxing	Optional kernel isolation via Anthropic's sandbox-runtime
Local execution	No cloud dependencies, everything runs locally on your machine

Usage

Component	Description
Python SDK	Python API for building applications on ipybox
MCP server	ipybox as MCP server for code actions and programmatic tool calling
Claude Code plugin	Plugin that bundles the ipybox MCP server and a code action skill

[!TIP] Freeact agent

Freeact is a general-purpose agent built on ipybox.

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-gradion-ai-ipybox": {
      "command": "uvx",
      "args": [
        "ipybox"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

io.github.gradion-ai/ipybox works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

io.github.gradion-ai/ipybox