英语| 中文
代理docker mcp🐳
该项目是一个轻量级的重构版本 代理沙盒平台.
支持模型上下文协议（MCP）的轻量级Docker沙盒CLI。 为AI代理（如Cursor）构建，为它们提供了一个安全、隔离和可丢弃的环境来运行代码和命令。
](https://www.npmjs.com/package/agent-docker) 
当使用本地AI编码助手时，您通常希望他们运行测试、安装依赖项或执行shell命令，而不会弄乱您的主机。 agent-docker-mcp 无缝创建一个映射到您的项目的临时Docker容器，将其作为MCP服务器公开，供AI安全使用。
⚠️ 注： 该项目目前处于早期开发阶段 仅在Linux上使用Cursor IDE进行了测试.MOSC/Windows支持和与其他MCP客户端的兼容性可能会有所不同。
✨ 特性
- 即时沙盒： 立即启动一个隔离的环境，将身份完美地挂载到您当前的工作目录中。
- 原生MCP支持： 为代理提供标准工具，以安全地运行bash命令。
- 自动脚手架： 自动设置
.cursor/mcp.json或.vscode/mcp.json与您最喜欢的IDE集成。 - 会话历史记录和回放： 内置SQLite跟踪记录每个命令及其输出。你甚至可以像一个asciinema演员一样“重播”这个环节！
🚀 快速开始
先决条件:
- Node.js>=18.0.0
- Docker桌面/引擎正在运行
您可以直接使用以下命令运行我们的CLI npx （无需安装）：
# 1. Initialize the sandbox and setup agent configurations
npx agent-docker-mcp init
# 2. Start the sandbox for your project
npx agent-docker-mcp start🛠 与AI IDE集成
光标
通过运行 npx agent-docker-mcp init 在项目根目录中，CLI执行繁重的工作：
- 检查Docker运行状况并提取默认沙盒映像。
- 自动创建
.cursor/mcp.json（或.vscode/mcp.json)用于MCP集成。 - 自动创建
.cursorrules指示AI更喜欢沙盒而不是主机shell。
然后你需要去 Settings -> Tools & MCP 并启用 agent-docker MCP。
初始化后，AI代理将自动访问 agent-docker MCP工具！
副驾驶
跑 npx agent-docker-mcp init 在您的项目根目录中，一旦项目启动，代理将尝试启动MCP服务器本身！
📖 基本命令
# Initialize sandbox and scaffolding
npx agent-docker-mcp init
# Start a sandbox container for the current directory
npx agent-docker-mcp start
# Execute a command inside the sandbox manually
npx agent-docker-mcp exec "npm run test"
# List active sandbox containers
npx agent-docker-mcp ps
# Stop the current sandbox
npx agent-docker-mcp stop
# List past sandbox sessions
npx agent-docker-mcp history
# Replay a specific session log (great for debugging agent actions)
npx agent-docker-mcp replay
# Clean up orphaned sandbox containers
npx agent-docker-mcp cleanup🧠 原理
- 身份挂载:
agent-docker将当前目录装载到容器中(ubuntu-默认情况下基于）使用完全相同的路径。代理生成或编辑的任何代码都会立即反映在您的主机上。 - MCP服务器：生成标准配置后(
init)，AI连接到npx agent-docker serve，拿起专用工具(exec_bash等）在容器内。 - 执行与审计：命令通过以下方式发送到Docker
dockerode图书馆。解析执行流，并将其安全地记录到本地SQLite中(~/.agent-docker/db.sqlite)，并安全返回AI。
📄 许可证
Apache许可证。