# Magentic-UI — Human-Centered Web Agent with MCP

> Magentic-UI gives teams a human-in-the-loop web agent with plan previews, approval gates, Docker-backed execution, and MCP support.

## Install

Copy the content below into your project:

## Quick Use

1. Create a virtualenv and install:
   ```bash
   python3 -m venv .venv
   source .venv/bin/activate
   pip install magentic-ui --upgrade
   export OPENAI_API_KEY="your-api-key-here"
   ```
2. Launch the UI:
   ```bash
   magentic-ui --port 8081
   ```
3. Verify:
   - Open `http://localhost:8081`, review the planned steps, and approve one low-risk action.

## Intro

Magentic-UI gives teams a human-in-the-loop web agent with plan previews, approval gates, Docker-backed execution, and MCP support.

- **Best for:** teams that need browser automation with explicit plans and approval steps
- **Works with:** Python 3.10+, Docker, web UI, command-line mode, MCP agents, optional Azure or Ollama installs
- **Setup time:** 15-30 minutes

## Practical Notes

- Quant: the README supports Python 3.10-3.13 and starts on `http://localhost:8081`.
- Quant: it documents at least three runtime modes out of the box: Docker-backed UI, `--run-without-docker`, and the `magentic-cli` path.

## Why it matters

Magentic-UI matters because it keeps humans visibly in the loop for web tasks instead of hiding planning and sensitive actions behind a single opaque run button.

- Plan previews and approval requests are a better fit for real browser operations than silent autonomous clicks.
- The project supports MCP-backed agents, which means browser work can be combined with tool access rather than isolated in a single sandbox.
- The maintainers document both full Docker mode and limited no-Docker mode, making trade-offs explicit.

## Rollout pattern

- Use the default Docker-backed path first so you validate the intended execution environment.
- Pilot low-risk web tasks such as monitoring or read-only extraction before approving form submissions or purchases.
- Add MCP agents only after you understand what the core UI agent already does well on its own.

## Watchouts

The no-Docker mode is explicitly limited, so teams should not assume it offers the same execution guarantees as the full default setup.

### FAQ

**Q: Can I run it without Docker?**
A: Yes, but the README marks `--run-without-docker` as limited because code execution is unavailable.

**Q: Why is this safer than a black-box browser agent?**
A: It exposes the plan and asks for approval on sensitive operations.

**Q: What is the first real test?**
A: Open the UI, inspect the proposed steps, and approve a low-risk browsing or monitoring task.

## Source & Thanks

> Source: https://github.com/microsoft/magentic-ui
> License: MIT
> GitHub stars: 9,805 · forks: 979

---

<!-- ZH -->

## 快速使用

1. 创建虚拟环境并安装：
   ```bash
   python3 -m venv .venv
   source .venv/bin/activate
   pip install magentic-ui --upgrade
   export OPENAI_API_KEY="your-api-key-here"
   ```
2. 启动界面：
   ```bash
   magentic-ui --port 8081
   ```
3. 验证：
   - 打开 `http://localhost:8081`，查看执行计划，并批准一次低风险动作。

## 简介

Magentic-UI 提供可预览计划、带审批闸门、依赖 Docker 执行并支持 MCP agent 的 Web 自动化代理，让浏览器任务更易检查，也更方便把敏感操作持续留在人工可控范围内。

- **适合谁：** 需要带计划预览和审批步骤的浏览器自动化团队
- **可搭配：** Python 3.10+、Docker、Web UI、命令行模式、MCP agents 以及可选的 Azure/Ollama 安装
- **准备时间：** 15-30 分钟

## 实战建议

- 量化信息：README 标注支持 Python 3.10-3.13，默认入口是 `http://localhost:8081`。
- 量化信息：它至少明确给出了三种运行方式：Docker-backed UI、`--run-without-docker` 与 `magentic-cli`。 

## 为什么值得收录

Magentic-UI 的价值在于它没有把浏览器自动化藏进一个黑箱按钮，而是让人始终看得见计划和审批点。

- 计划预览和审批请求比“静默自动点击”更适合真实浏览器操作场景。
- 支持 MCP agents，意味着浏览器任务可以和其他工具能力结合，而不是被隔离成一个孤立沙箱。
- 维护者明确区分了完整 Docker 模式和受限的无 Docker 模式，取舍关系写得很清楚。

## 落地路径

- 第一次先走默认 Docker 路径，确认执行环境符合项目预期。
- 先试只读监控或信息提取类任务，再逐步批准表单提交、购买等敏感操作。
- 在看清核心 UI agent 的边界之前，不要过早叠加 MCP agents。 

## 注意事项

README 已明确指出无 Docker 模式能力受限，因此不要把它和完整默认模式当成等价运行环境。

### FAQ

**可以不装 Docker 吗？**
答：可以，但 README 已说明 `--run-without-docker` 是受限模式，不能做完整代码执行。

**为什么它比黑箱浏览器 Agent 更安全？**
答：因为它会先展示计划，并在敏感动作前请求审批。

**第一步真实测试做什么？**
答：打开 UI，检查计划，再批准一个低风险浏览或监控任务。

## 来源与感谢

> Source: https://github.com/microsoft/magentic-ui
> License: MIT
> GitHub stars: 9,805 · forks: 979


---
Source: https://tokrepo.com/en/workflows/magentic-ui-human-centered-web-agent-with-mcp
Author: Script Depot