ipybox について
ipybox は、Python コード、シェルコマンド、プログラムによる MCP ツール呼び出しを、ステートフルな IPython カーネルで実行する統合実行環境です。ローカルで動作し、ローカルのデータやツールを保護したまま利用したい開発者向けです。
主な機能
- 01IPython カーネルによるステートフルな実行
- 021 つのコードブロックでの Python・シェル・MCP 呼び出しの組み合わせ
- 03MCP ツールスキーマから生成される型付き Python API
- 04個別のツール呼び出しとシェルコマンドの承認
- 05OS レベルのカーネルサンドボックスによる任意の分離
活用シーン
- 01エージェントによる JSON ではなくコードを介した MCP ツールの呼び出し
- 02エージェントが生成したコードのローカルでの制御された実行
- 03Claude Code へのコードアクションスキルの追加
MCP 対応
ipybox は MCP サーバーとして動作し、コード実行とプログラムによるツール呼び出しを MCP クライアントに提供します。また、MCP サーバーのツールから Python API を生成します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
ipybox
mcp-name: io.github.gradion-ai/ipybox
ipybox は、Python コード、シェルコマンド、プログラムによる MCP ツール呼び出しのための統合実行環境です。
概要
ipybox は、ステートフルな IPython カーネルでコードブロックを実行します。コードブロックには、Python コード、シェルコマンド、プログラムによる MCP ツール呼び出しを任意に組み合わせて含めることができます。sandbox-runtime を使ってカーネルをサンドボックス化し、OS レベルでファイルシステムとネットワークを制限できます。
mcpygen を介して MCP サーバーのツール用 Python API を生成し、コード実行中に個々のツール呼び出しやシェルコマンドをアプリケーションレベルで承認できます。ipybox はお使いのコンピューター上でローカルに実行されるため、ローカルのデータやツールへのアクセスを保護できます。
メモ
次世代の ipybox
これは ipybox の次世代版で、全面的に書き直されています。以前のバージョンは0.6.x ブランチで保守されており、
pip install ipybox<0.7で入手できます。
ドキュメント:
- 📚 ドキュメント
- 🏗️ アーキテクチャ
- 🤖 llms.txt
- 🤖 llms-full.txt
機能
| 機能 | 説明 |
|---|---|
| ステートフルな実行 | IPython カーネルでは、実行をまたいで状態が保持されます |
| 統合実行 | Python コード、シェルコマンド、プログラムによる MCP ツール呼び出しをコードブロック内で組み合わせられます |
| シェルコマンドの実行 | !cmd 構文でシェルコマンドを実行し、出力を Python 変数に取り込めます |
| プログラムによる MCP ツール呼び出し | MCP ツールは JSON で直接ではなく、生成された Python API(「コードモード」)を介して呼び出されます |
| Python ツール API の生成 | mcpygen を介して、MCP ツールのスキーマから型付き関数と Pydantic モデルを生成します |
| アプリケーションレベルでの承認 | コード実行中に、ツール呼び出しとシェルコマンドを個別に承認できます |
| 軽量なサンドボックス化 | Anthropic の sandbox-runtime を介して、カーネルを任意で隔離できます |
| ローカル実行 | クラウドへの依存がなく、すべてお使いのマシン上でローカルに実行されます |
使い方
| コンポーネント | 説明 |
|---|---|
| Python SDK | ipybox 上でアプリケーションを構築するための Python API |
| MCP サーバー | コードアクションとプログラムによるツール呼び出しのための MCP サーバーとしての ipybox |
| Claude Code プラグイン | ipybox MCP サーバーとコードアクションスキルをバンドルしたプラグイン |
ヒント
Freeact エージェント
Freeact は ipybox 上に構築された汎用エージェントです。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。