Gru Sandbox

🚀 gbox

gbox は強力なコンテナ化ツールで、開発者が sandbox コンテナを簡単に管理できるように設計されています。コンテナの作成、起動、停止、削除を行うための完全なコマンドラインインターフェース（CLI）を提供し、MCP サーバーとの統合もサポートしています。

gbox を使用することで、以下のことが可能です。

• Docker 互換のボリュームマウントを使用して、ホストディレクトリとコンテナディレクトリをマッピングする。
• MCP 設定を構成してエクスポートし、Claude Desktop などのツールとやり取りする。
• 実行中のコンテナを確認および管理する。
• 新機能を迅速に開発および構築する。

🚀 クイックスタート

gbox を使えば、sandbox コンテナを簡単に管理できます。コマンドラインインターフェースを通じて、コンテナの基本操作や MCP サーバーとの統合を行うことができます。

✨ 主な機能

• Docker 互換のボリュームマウントによるホストディレクトリとコンテナディレクトリのマッピング。
• MCP 設定の構成とエクスポート。
• 実行中のコンテナの管理。
• 新機能の迅速な開発と構築。

📦 インストール

システムパッケージマネージャーを使用したインストール

# Debian/Ubuntu システム
sudo apt-get install gbox

# CentOS/RHEL システム
sudo yum install gbox

手動インストール

最新バージョンの gbox をダウンロードし、公式ドキュメント の説明に従ってインストールします。

💻 使用例

基本的な使用法

コンテナ管理

# 新しいコンテナを作成する
gbox box create --image 镜像名称 [--env 环境变量] [-w 工作目录] [-v 主机路径:容器路径[:只读][:传播模式]]

# すべてのコンテナをリストする
gbox box list

# 指定されたコンテナを起動する
gbox box start <容器ID>

# 指定されたコンテナを停止する
gbox box stop <容器ID>

# 指定されたコンテナを削除する
gbox box delete <容器ID>

# コンテナ内でコマンドを実行する
gbox box exec <容器ID> -- <可执行文件> [<参数>...]

# コンテナの詳細情報を表示する
gbox box inspect <容器ID>

MCP 設定

# MCP 設定をエクスポートする
gbox mcp export

# 設定を Claude Desktop にマージする
gbox mcp export --merge-to claude

# 実際に変更を適用せずにマージ結果をプレビューする
gbox mcp export --dry-run

高度な使用法

ボリュームマウント

gbox box create コマンドは Docker 互換のボリュームマウント形式をサポートしています。

-v /主机路径:/容器路径[:只读][:传播模式]

ボリュームマウントの例

# 基本的なバインドマウント
gbox box create -v /data:/data --image python:3.9

# 読み取り専用のバインドマウント
gbox box create -v /data:/data:ro

# 複数のバインドマウント
gbox box create \
  -v /config:/etc/myapp \
  -v /data:/var/lib/myapp:ro \
  -v /logs:/var/log/myapp:ro:rprivate \
  --image python:3.9

⚠️ 重要提示 ホストパスはコンテナを作成する前に存在している必要があり、コンテナパスは必要に応じて自動的に作成されます。

📚 ドキュメント

開発環境のセットアップ

前提条件

• Go 1.21 以上
• Docker Desktop
• Make ツール
• pnpm（corepack を通じてインストール）
• Node.js 16.13 以上

プロジェクトのコンパイル

# すべてのコンポーネントをコンパイルする
make build

# リリースパッケージを作成する
make dist

サービスの実行

# API サーバーを起動する
npm run dev

# API サーバーをテストする
npm test

# 型チェックを実行する
npm run type-check

貢献ガイドライン

どんな貢献も歓迎します！詳細については、CONTRIBUTING.md ファイルを参照してください。 💡 使用建议

• 各コミットには明確な説明を付ける。
• マージリクエストには関連するテストケースとドキュメントの更新を含める。
• コードスタイルガイドラインに従う。

📄 ライセンス

このプロジェクトは MIT ライセンス の下で保護されています。