pypi ipyboxstdioApache-2.0updated 2mo ago
ipybox is a unified execution environment for Python code, shell commands, and programmatic MCP tool calls.
Was kannst du mit ipybox machen?
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:
- đ Documentation
- đïž Architecture
- đ€ llms.txt
- đ€ llms-full.txt
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.
Installation
ipybox zu deinem Client hinzufĂŒgen. WĂ€hl den, den du nutzt.
claude mcp add ipybox -- uvx ipyboxcodex mcp add ipybox -- uvx ipyboxamp mcp add ipybox -- uvx ipybox{
"mcpServers": {
"ipybox": {
"command": "uvx",
"args": [
"ipybox"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"ipybox": {
"command": "uvx",
"args": [
"ipybox"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"ipybox","command":"uvx","args":["ipybox"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"ipybox": {
"command": "uvx",
"args": [
"ipybox"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"ipybox": {
"command": "uvx",
"args": [
"ipybox"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"ipybox": {
"command": "uvx",
"args": [
"ipybox"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"ipybox": {
"type": "local",
"command": "uvx",
"args": [
"ipybox"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"ipybox": {
"command": {
"path": "uvx",
"args": [
"ipybox"
]
}
}
}
}Add to your Zed `settings.json`.
uvx ipyboxRun `goose configure`, choose **Add Extension â Command-line Extension**, and paste this command.
Score
39 / 100
UnvollstÀndig
- Dokumentation12/25
- Pflege22/25
- Vertrauen16/20
- Funktionsumfang0/15
- Installation12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 82 days ago
- Has a release history
- Repository is not archived
- Licensed Apache-2.0
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint â no local install
Versionsverlauf
| Versionen | Veröffentlicht |
|---|---|
| 0.9.2Aktuell | 1. Juni 2026 |
| 0.9.1 | 24. MĂ€rz 2026 |
| 0.9.0 | 21. MĂ€rz 2026 |
| 0.8.2 | 15. MĂ€rz 2026 |
| 0.8.1 | 13. MĂ€rz 2026 |
| 0.8.0 | 4. MĂ€rz 2026 |
| 0.7.7 | 3. MĂ€rz 2026 |
| 0.7.6 | 2. MĂ€rz 2026 |
| 0.7.5 | 21. Feb. 2026 |
| 0.7.4 | 9. Feb. 2026 |
| 0.7.3 | 5. Feb. 2026 |
| 0.7.2 | 5. Jan. 2026 |
| 0.7.1 | 10. Dez. 2025 |
| 0.7.0 | 9. Dez. 2025 |
| 0.6.7 | 25. Nov. 2025 |
| 0.6.6 | 14. Sept. 2025 |
| 0.6.5 | 14. Sept. 2025 |
| 0.6.3-p2 | 14. Sept. 2025 |
| auto | 14. Sept. 2025 |
| 0.6.3-p1 | 14. Sept. 2025 |
| 0.6.3 | 13. Sept. 2025 |