Ipybox

io.github.gradion-ai由 GitHub 帳號 gradion-ai 發布v0.9.2更新於 Oct 24, 2026

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

已驗證STDIO僅桌面開發者工具AI 與機器學習

概覽

AI 產生的概覽

在本機具狀態的 IPython 核心中執行 Python 程式碼、shell 指令與 MCP 工具呼叫。

可以做什麼
Ipybox 提供統一的執行環境，單一程式碼區塊可混合 Python 程式碼、shell 指令與程式化 MCP 工具呼叫。狀態會在 IPython 核心中跨執行持續保存，shell 輸出可擷取到 Python 變數中。它會依 MCP 工具結構描述產生具型別的 Python API 與 Pydantic 模型，並支援在程式碼執行期間對個別工具呼叫與 shell 指令進行應用層審核。核心可選擇透過 sandbox-runtime 進行沙箱隔離，以限制檔案系統與網路存取。
適用情境
適合助理需要執行具持續狀態的多步驟 Python 或 shell 工作，或透過產生的 Python API 而非原始 JSON 呼叫 MCP 工具的情境。適用於需要受保護地存取本機資料與工具的本機工作流程，也可作為 MCP 伺服器用於程式碼動作與程式化工具呼叫。
執行需求
以 stdio 程序在本機執行，從 PyPI 安裝 ipybox 並以 uvx 啟動。未宣告驗證、環境變數或標頭。選用沙箱使用 sandbox-runtime。僅限桌面端，無網頁可執行版本。
安裝前請注意
它會在使用者機器上執行任意 Python 程式碼與 shell 指令，執行前應審查程式碼與指令。可對個別工具呼叫與 shell 指令啟用應用層審核，建議開啟。沙箱為選用而非預設，只有設定後才會套用檔案系統與網路限制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ipybox，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[ipybox]

ipybox

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

[Website] [PyPI - Version] [GitHub Release] [GitHub Actions Workflow Status] [GitHub License]

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

CapabilityDescription
Stateful executionState persists across executions in IPython kernels
Unified executionCombine Python code, shell commands, and programmatic MCP tool calls in a code block
Shell command executionRun shell commands via !cmd syntax, capture output into Python variables
Programmatic MCP tool callsMCP tools called via generated Python API ("code mode"), not JSON directly
Python tool API generationTyped functions and Pydantic models generated from MCP tool schemas via mcpygen
Application-level approvalIndividual approval of tool calls and shell commands during code execution
Lightweight sandboxingOptional kernel isolation via Anthropic's sandbox-runtime
Local executionNo cloud dependencies, everything runs locally on your machine

Usage

ComponentDescription
Python SDKPython API for building applications on ipybox
MCP serveripybox as MCP server for code actions and programmatic tool calling
Claude Code pluginPlugin that bundles the ipybox MCP server and a code action skill

[!TIP] Freeact agent

Freeact is a general-purpose agent built on ipybox.

來源：README.md，提交 264ed6c

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.9.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分