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 分