关于 ipybox
ipybox 是一个统一执行环境,可在有状态的 IPython 内核中运行 Python 代码、Shell 命令和程序化 MCP 工具调用。它在本地运行,面向需要保护本地数据和工具的开发者。
主要功能
- 01有状态的 IPython 内核执行
- 02在同一代码块中组合 Python、Shell 与 MCP 调用
- 03由 MCP 工具 schema 生成类型化 Python API
- 04工具调用与 Shell 命令的应用级审批
- 05可选的 OS 级内核沙箱隔离
适用场景
- 01让 Agent 通过代码而非 JSON 调用 MCP 工具
- 02在本地环境中受控地执行 Agent 生成的代码
- 03在 Claude Code 中使用代码执行技能
MCP 相关
ipybox 可作为 MCP 服务运行,向 MCP 客户端提供代码执行与程序化工具调用能力;它也能为连接的 MCP 服务器生成 Python API。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
ipybox
mcp-name: io.github.gradion-ai/ipybox
ipybox 是一个统一的执行环境,可运行 Python 代码、Shell 命令和以编程方式调用 MCP 工具。
概述
ipybox 在有状态的 IPython 内核中执行代码块。一个代码块可以包含任意组合的 Python 代码、Shell 命令和以编程方式调用的 MCP 工具。内核可以通过 sandbox-runtime 进行沙盒隔离,在操作系统层面实施文件系统和网络限制。
ipybox 通过 mcpygen 为 MCP 服务工具生成 Python API,并支持在代码执行期间对单个工具调用和 Shell 命令进行应用级审批。ipybox 在你的计算机本地运行,从而能够安全地访问本地数据和工具。
说明
新一代 ipybox
这是新一代 ipybox,是一次完整重写。旧版本在 0.6.x 分支上维护,可通过
pip install ipybox<0.7安装。
文档:
- 📚 文档
- 🏗️ 架构
- 🤖 llms.txt
- 🤖 llms-full.txt
功能
| 功能 | 描述 |
|---|---|
| 有状态执行 | IPython 内核中的状态会在多次执行之间保留 |
| 统一执行 | 在一个代码块中组合 Python 代码、Shell 命令和以编程方式调用的 MCP 工具 |
| Shell 命令执行 | 使用 !cmd 语法运行 Shell 命令,并将输出捕获到 Python 变量中 |
| 以编程方式调用 MCP 工具 | 通过生成的 Python API(“代码模式”)调用 MCP 工具,而非直接使用 JSON |
| Python 工具 API 生成 | 通过 mcpygen 根据 MCP 工具架构生成带类型的函数和 Pydantic 模型 |
| 应用级审批 | 在代码执行期间单独审批工具调用和 Shell 命令 |
| 轻量级沙盒隔离 | 可选通过 Anthropic 的 sandbox-runtime 隔离内核 |
| 本地执行 | 无云端依赖,所有操作都在你的计算机本地运行 |
用法
| 组件 | 描述 |
|---|---|
| Python SDK | 用于基于 ipybox 构建应用的 Python API |
| MCP 服务 | 将 ipybox 用作 MCP 服务,以执行代码操作和以编程方式调用工具 |
| Claude Code 插件 | 集成 ipybox MCP 服务和代码操作技能的插件 |
提示
Freeact Agent
Freeact 是一个基于 ipybox 构建的通用 Agent。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。