mcpField
I
ipybox

ipybox

本地服务
github.com/gradion-ai开发工具7620 周前更新

关于 ipybox

ipybox 是一个统一执行环境,可在有状态的 IPython 内核中运行 Python 代码、Shell 命令和程序化 MCP 工具调用。它在本地运行,面向需要保护本地数据和工具的开发者。

主要功能

  1. 01有状态的 IPython 内核执行
  2. 02在同一代码块中组合 Python、Shell 与 MCP 调用
  3. 03由 MCP 工具 schema 生成类型化 Python API
  4. 04工具调用与 Shell 命令的应用级审批
  5. 05可选的 OS 级内核沙箱隔离

适用场景

  1. 01让 Agent 通过代码而非 JSON 调用 MCP 工具
  2. 02在本地环境中受控地执行 Agent 生成的代码
  3. 03在 Claude Code 中使用代码执行技能

MCP 相关

ipybox 可作为 MCP 服务运行,向 MCP 客户端提供代码执行与程序化工具调用能力;它也能为连接的 MCP 服务器生成 Python API。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"gradion-ai-ipybox": {
"command": "uvx",
"args": [
"ipybox"
]
}
}
}
启动命令uvx ipybox

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
pypiipybox0.9.2

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

ipybox

ipybox

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

网站 PyPI - 版本 GitHub 发布版本 GitHub Actions 工作流状态 GitHub 许可证

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 安装。

文档:

功能

功能描述
有状态执行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。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。