本地 AI Agent 的统一管理中心。
添加 Agent 后，用户可在这里实现：
- 一键启动 / 停止，实时查看日志
- 内嵌 Web UI 与交互式终端
- 用自然语言指挥所有 Agent
- 一键生成临时公网分享链接
✨ 项目亮点 · 🤝 推荐搭配 · ⚙️ 快速安装 · 🚀 快速上手 · 🤖 LLM 配置 · 🌐 分享 Agent · ❓ FAQ
📚 完整目录
智管-Agent Manager 是一个基于 Tauri 2 + React 19 的桌面应用，专门解决"本机跑了一堆 AI Agent，管理混乱"的问题。
核心理念：所有 Agent，一个窗口管到底。
- 不用开多个终端
- 不用记各种启动命令
- 不用手动打开浏览器找端口
- 用自然语言就能操控所有 Agent
智管-Agent Manager 可以统一管理本地运行的各类 AI Agent。 如果你正在寻找一个适合被智管托管的业务型 Agent，推荐搭配使用：
📊 智能商业分析 Agent
智能商业分析 Agent 是一个面向商业数据分析场景的 AI Agent。 上传 Excel / CSV，或连接数据库后，用户可以直接用自然语言提问，系统会自动完成：
- 数据结构识别
- SQL 生成与执行
- 图表推荐与生成
- 业务洞察分析
- Excel / Word / PPT 报告导出
配合智管-Agent Manager 使用后，可以获得更完整的桌面端体验：
| 使用场景 | 智管-Agent Manager 提供的能力 |
|---|---|
| 启动商业分析 Agent | 一键启动 / 停止进程 |
| 查看运行状态 | 实时日志、PID、端口状态 |
| 打开分析界面 | 内嵌 Web UI，无需切换浏览器 |
| 团队临时演示 | 一键生成 Cloudflare Tunnel 公网链接 |
| 多 Agent 协作 | 使用 Manager Agent 自然语言调度 |
示例：
帮我启动 Business Analytics Agent，然后打开它的界面
👉 项目地址：智能商业分析 Agent
所有 Agent 以可视化展示：Manager Agent 在讲台，其他 Agent 坐在学生座位上。
一眼看清所有 Agent 的状态，悬停在 Agent 座位上，可直接：
- 启动 / 停止
- 查看详情
- 打开 UI 界面
点击讲台的 Manager Agent，直接跳转到自然语言指挥界面。
用一句话控制所有 Agent，无需手动操作界面。
帮我启动 Business Analytics Agent，然后打开它的界面
把 Mindmap 停掉，顺便告诉我它是干什么的
现在有哪些 Agent 在运行？
Manager Agent 会理解意图 → 自动调用工具 → 完成操作，并向你汇报结果。
支持的操作：
| 自然语言描述 | 实际行为 |
|---|---|
| 启动 / 停止某个 Agent | 调用 start/stop 接口 |
| 打开某个 Agent 的界面 | 自动在标签栏打开 UI |
| 打开某个 Agent 的终端 | 自动在标签栏打开 PTY 终端 |
| 查看所有 Agent 状态 | 返回实时状态汇总表 |
| 了解某个 Agent 的功能 | 读取该 Agent 目录下的 README |
| 跳转到某个页面 | 自动导航 |
会话持久化： 切换到其他页面再回来，对话历史不丢失。
需要配置 LLM 提供商才能使用，详见 LLM 配置说明。
选择项目目录后，自动检测并填写启动命令，无需手动填写。详见支持的项目类型。
- 一键启动 / 停止 Agent 进程
- 实时流式日志（stdout + stderr），支持自动滚动
- 查看 PID、端口状态、启动时间
- 侧边栏支持拖拽排序
有 Web 界面的 Agent（如 Streamlit、Flask、FastAPI）可以直接在应用内打开，不用切换浏览器：
- 多标签页同时打开多个 Agent UI
- 标签栏高度可拖拽调整
- 支持一键全屏
- 支持 WebSocket Token 自动填充（openclaw 类型 Agent）
通过 MCP（Model Context Protocol）连接本地工具服务，与 AI 进行多轮工具调用对话。
MCP 服务器添加方式：
- 本地扫描：自动检测 npm 全局安装的 MCP 包
- 智能解析：粘贴任意文本（官方文档、安装说明等），AI 自动提取配置
- 手动添加：填写 stdio / SSE 配置
无需固定 IP，无需域名，无需服务器。一键生成临时公网链接：
你的电脑 localhost:5001
↓ Cloudflare Tunnel
https://abc-xyz.trycloudflare.com ← 发给同事
使用流程：
- 安装 cloudflared（见下方）
- 确认 Agent 已启动
- 在"代理发布"页找到目标 Agent → 点击 生成链接
- 等待约 5–15 秒，出现
https://xxx.trycloudflare.com - 复制链接发给同事
- 会后点 关闭，链接立即失效
安装 cloudflared：
# Windows（推荐用 Scoop）
scoop install cloudflared
# macOS
brew install cloudflared或从 GitHub Releases 直接下载 exe。
⚠️ 临时链接无访问控制，请仅在需要时开启，会后立即关闭。
适合需要固定域名、持续开放访问的场景：
- 绑定自定义域名（自动申请 HTTPS 证书）
- 用户名 / 密码访问控制（bcrypt 加密存储）
- 多用户权限精细管理（每条规则可独立设置允许哪些用户访问）
- 一键生成 Caddyfile + 启动/重载 Caddy
查看当前机器上所有正在监听的端口：
- 显示端口号、协议、PID、进程名
- 一键终止占用指定端口的进程
- 方便排查 Agent 启动失败（端口被占用）的问题
从 Releases 下载最新版本：
| 平台 | 文件 |
|---|---|
| Windows | Agent-Manager.exe |
| macOS（Intel） | Agent-Manager.dmg |
双击安装包，按提示安装即可。
前置依赖：
- Node.js ≥ 18
- Rust（stable）
- Tauri 前置依赖（Windows 需要 VS C++ 生成工具）
git clone https://github.com/Zafer-Liu/Agent_MCP_Manager.git
cd Agent_MCP_Manager
# 安装依赖
npm install
cd frontend && npm install && cd ..
# 开发模式运行
npm run dev
# 生产构建
npm run build构建产物在 src-tauri/target/release/bundle/ 下。
- 侧边栏点击 Agents → 右上角 ＋ New Agent
- 点击 📁 选择 Agent 的项目目录
- 应用自动识别项目类型，填写启动命令
- 填写名称，确认端口号（有 Web UI 的 Agent 需要）→ 保存
- 点击 ▶ 启动
- 有 Web UI 的 Agent（Streamlit / Flask 等）：点击 Open UI → 在应用内嵌标签页打开
- TUI 类 Agent（Claude Code 等）：点击 Open Terminal → 在应用内嵌终端打开
- 在 MCP Agent → LLM 设置 中添加 LLM 提供商（见LLM 配置说明）
- 点击侧边栏 Manager
- 选择 LLM 提供商
- 用自然语言发送指令
- 安装 cloudflared
- 打开代理发布页面
- 找到目标 Agent → 生成链接 → 复制发送
Manager Agent 和 MCP Agent 都需要 LLM 驱动。在 MCP Agent → LLM 设置 中添加：
| 字段 | 说明 | 示例 |
|---|---|---|
| 名称 | 自定义，随便填 | DeepSeek |
| Base URL | OpenAI 兼容的 API 地址 | https://api.deepseek.com/v1 |
| API Key | 对应的 API Key | sk-xxx |
| 模型 | 模型名称 | deepseek-chat |
点击测试连接，显示绿色即配置成功。
内置支持的提供商：
| 提供商 | Base URL | 推荐模型 |
|---|---|---|
| DeepSeek | https://api.deepseek.com/v1 |
deepseek-chat |
| OpenAI | https://api.openai.com/v1 |
gpt-4o-mini |
| 任意兼容 API | 自定义 | 自定义 |
选择项目目录后，自动检测并填写以下配置：
| 项目类型 | 识别条件 | 自动生成的命令 |
|---|---|---|
| Python · uv | pyproject.toml + uv.lock |
uv run python main.py |
| Python · FastAPI | requirements 含 fastapi |
uvicorn main:app --reload --port PORT |
| Python · Django | manage.py 存在 |
python manage.py runserver 0.0.0.0:8000 |
| Python · Streamlit | requirements 含 streamlit |
streamlit run app.py --server.port 8501 |
| Python · Flask | requirements 含 flask |
python app.py |
| Python · 通用 | main.py / app.py 等 |
python main.py |
| Node.js | package.json |
npm run dev |
| Rust | Cargo.toml |
cargo run |
| Go | go.mod |
go run . |
| npm 全局命令 | %APPDATA%\npm\*.cmd |
交互式 PowerShell + 自动输入命令 |
| 可执行文件 | .exe / .bat / .cmd / .sh |
直接运行 |
端口号也会自动检测：扫描 .env 文件、pyproject.toml 脚本、源码中的 port= 配置。
| 数据 | Windows | macOS |
|---|---|---|
| Agent 配置 | %APPDATA%\agent-manager\agents.json |
~/Library/Application Support/agent-manager/agents.json |
| LLM 提供商 | %APPDATA%\agent-manager\llm_config.json |
同左 |
| 代理 / 用户配置 | %APPDATA%\agent-manager\proxy.json |
同左 |
| 生成的 Caddyfile | %APPDATA%\agent-manager\Caddyfile |
同左 |
| MCP 服务器配置 | %APPDATA%\Claude\claude_desktop_config.json |
~/Library/Application Support/Claude/claude_desktop_config.json |
当前版本
v0.2.0· 2026 年 6 月
新功能：
- ✅ Manager Agent：自然语言指挥所有 Agent，支持启动/停止/打开 UI/读取 README
- ✅ Dashboard 教室视图：所有 Agent 状态一眼可见，悬停操作
- ✅ 代理发布：一键 Cloudflare Tunnel 临时分享 + Caddy 反向代理长期发布
- ✅ PTY 终端：真实交互式终端，支持 Claude Code 等 TUI 工具
- ✅ Python 自动识别增强：支持 FastAPI/Django/Streamlit/uv/pyproject.toml
- ✅ 会话持久化：Manager Agent 切换页面不丢失对话历史
修复：
- 修复从 Dashboard 启动 Agent 后全屏卡死问题
- 修复 Mindmap（Node.js）启动进入 REPL 的问题
- 修复开发端口与其他 Vite 项目冲突（改为 1420）
🤖 Manager Agent 相关
Manager Agent 没有反应 / 提示未选择提供商？
- 前往 MCP Agent → LLM 设置，添加 LLM 提供商
- 点击"测试连接"，确认绿色通过
- 回到 Manager 页面，在顶部下拉框选择该提供商
Manager Agent 说"找不到 Agent"？
LLM 使用的是 Agent 的名称，确认你说的名称和 Agent 配置中的名称一致（支持模糊匹配，不区分大小写，也支持用下划线替代空格）。
切换页面后 Manager Agent 对话历史消失了？
这是 v0.2.0 已修复的问题。Manager Agent 组件始终在后台保持挂载，只是通过 CSS 隐藏。如果仍然消失，请确认使用的是 v0.2.0 版本。
🤖 Agent 管理相关
Agent 启动后状态显示"错误"？
查看 Agent 详情页的日志，通常是：
- 端口被占用：在 Port Manager 找到占用该端口的进程并终止
- 依赖未安装：在终端手动运行一次启动命令，查看具体报错
- 工作目录不对：确认 Agent 配置中的工作目录路径正确
Agent 有 Web UI 但打开后是空白？
Agent 可能还在启动中（端口尚未监听）。等待几秒后，点击 UI 面板工具栏的刷新按钮。
Claude Code 终端打开后是空白？
这是正常现象。应用会自动启动 PowerShell，然后等待约 800ms 后向 stdin 写入 claude 命令。稍等 1–2 秒，Claude Code 的 TUI 界面会渲染出来。
Python Agent 识别出的命令不对？
自动识别基于文件扫描，边缘情况可能判断有误。在 Agent 编辑界面手动修改命令和参数即可，修改后保存立即生效。
Agent 列表顺序能调整吗？
可以。在 Agents 页面，按住 Agent 左侧的拖动把手（悬停后出现的 ⠿ 图标），拖拽到目标位置即可。顺序自动保存。
🌐 代理发布相关
点击"生成链接"后一直没有 URL 出现？
可能原因：
- cloudflared 未安装或不在 PATH 中 → 点击"重新检测"按钮，确认路径已识别
- 网络问题 → cloudflared 需要能访问 Cloudflare，确认没有代理或防火墙拦截
- Agent 未启动 → 临时链接会转发到本机端口，Agent 需处于运行状态
同事打开链接显示"无法访问此网站"？
确认：
- Agent 在你本机正在运行（不是停止状态）
- 隧道还没有关闭（应用里还显示绿色 URL）
- 链接是完整的
https://xxx.trycloudflare.com格式
多个同事同时访问对话内容混在一起？
这是 Agent 本身的限制，对话历史存在 Agent 进程的内存里，Agent Manager 无法从外部隔离。
如需隔离，需在 Agent 代码中加 session 支持（如 Streamlit 使用 st.session_state 天然隔离）。
Caddy 找不到 / proxy_apply 失败？
安装 Caddy：
# Windows
scoop install caddy
# macOS
brew install caddy安装后在代理发布页点击刷新按钮。
⚙️ 安装与运行相关
Windows 安装包提示"未知发布者"？
点击"更多信息" → "仍要运行"。这是因为安装包未经过 Microsoft 代码签名，属于正常现象。
macOS 提示"无法打开，因为无法验证开发者"？
在终端执行：
xattr -d com.apple.quarantine /Applications/智管-Agent\ Manager.app或右键点击应用 → 选择"打开" → 再次点击"打开"。
开发模式 npm run dev 报端口占用？
本项目开发端口为 1420（避免与 Mindmap 等 Vite 项目的 5173 冲突）。如 1420 被占用：
# 查找占用进程
netstat -ano | findstr :1420
# 终止该进程（把 PID 替换为实际值）
taskkill /PID <PID> /F欢迎提交 PR 或 Issue！
把所有 Agent 的管理交给智管，把时间留给真正重要的事。