convez.ai
MCP ServerProdutividadeIntermediário
Zafer-Liu

Agent Manager

Zafer-Liu/Agent_Manager

Centro unificado para gerenciar todos os seus AI Agents localmente

Ver no GitHub
BomPluginScore · de 0 a 100

Aplicação desktop multiplataforma para gerenciar centralizadamente AI Agents e MCP Servers. Oferece inicialização com um clique, visualização de logs em tempo real, interface web integrada, terminal interativo e execução de agentes via linguagem natural.

Instalação

$npx convez-ai Zafer-Liu/Agent_Manager

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
169
Forks
33
Acompanhando
40
Saúde
42%
Último commit
há 1 dia
Versão
v1.3.1
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerenciar múltiplos AI Agents em um só dashboard
  • Executar comandos de agentes via linguagem natural
  • Iniciar/parar agentes e monitorar logs em tempo real
  • Compartilhar agentes temporariamente com links públicos

Veredito

Solução robusta (Tauri 2 + React 19) para quem tem múltiplos agentes rodando localmente e quer evitar terminal caótico. Manager Agent com linguagem natural é prático, mas requer setup inicial de cada agent compatível — não é plug-and-play universal.

README

A tradução para o português deste README ainda está na fila.

智管-Agent Manager

版本 License Platform Tauri React Rust

本地 AI Agent 的统一管理中心。
添加 Agent 后,用户可在这里实现:

  • 一键启动 / 停止,实时查看日志
  • 内嵌 Web UI 与交互式终端
  • 用自然语言指挥所有 Agent
  • 一键生成临时公网分享链接

✨ 项目亮点

智管-Agent Manager 是一个基于 Tauri 2 + React 19 的桌面应用,专门解决"本机跑了一堆 AI Agent,管理混乱"的问题。

核心理念:所有 Agent,一个窗口管到底。

  • 不用开多个终端
  • 不用记各种启动命令
  • 不用手动打开浏览器找端口
  • 用自然语言就能操控所有 Agent

🤝 推荐搭配 Agent

智管-Agent Manager 可以统一管理本地运行的各类 AI 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


🧠 核心功能

1️⃣ Dashboard — 教室视图

所有 Agent 以可视化展示:Manager Agent 在讲台,其他 Agent 坐在学生座位上。

classroom

一眼看清所有 Agent 的状态,悬停在 Agent 座位上,可直接:

  • 启动 / 停止
  • 查看详情
  • 打开 UI 界面

点击讲台的 Manager Agent,直接跳转到自然语言指挥界面。


2️⃣ Manager Agent — 自然语言指挥官

用一句话控制所有 Agent,无需手动操作界面。

manager

帮我启动 Business Analytics Agent,然后打开它的界面
把 Mindmap 停掉,顺便告诉我它是干什么的
现在有哪些 Agent 在运行?

Manager Agent 会理解意图 → 自动调用工具 → 完成操作,并向你汇报结果。

支持的操作:

自然语言描述实际行为
启动 / 停止某个 Agent调用 start/stop 接口
打开某个 Agent 的界面自动在标签栏打开 UI
打开某个 Agent 的终端自动在标签栏打开 PTY 终端
查看所有 Agent 状态返回实时状态汇总表
了解某个 Agent 的功能读取该 Agent 目录下的 README
跳转到某个页面自动导航

会话持久化: 切换到其他页面再回来,对话历史不丢失。

需要配置 LLM 提供商才能使用,详见 LLM 配置说明。


3️⃣ Agent 管理

自动识别项目类型

选择项目目录后,自动检测并填写启动命令,无需手动填写。详见支持的项目类型。

启动与监控

Agent1

  • 一键启动 / 停止 Agent 进程
  • 实时流式日志(stdout + stderr),支持自动滚动
  • 查看 PID、端口状态、启动时间
  • 侧边栏支持拖拽排序

内嵌 Web UI

Agent2 有 Web 界面的 Agent(如 Streamlit、Flask、FastAPI)可以直接在应用内打开,不用切换浏览器:

  • 多标签页同时打开多个 Agent UI
  • 标签栏高度可拖拽调整
  • 支持一键全屏
  • 支持 WebSocket Token 自动填充(openclaw 类型 Agent)

4️⃣ MCP Agent — AI 工具对话

mcp

通过 MCP(Model Context Protocol)连接本地工具服务,与 AI 进行多轮工具调用对话。

MCP 服务器添加方式:

  • 本地扫描:自动检测 npm 全局安装的 MCP 包
  • 智能解析:粘贴任意文本(官方文档、安装说明等),AI 自动提取配置
  • 手动添加:填写 stdio / SSE 配置

5️⃣ 代理发布 — 临时分享与公网访问

🔗 临时分享(推荐 · 适合开会场景)

agency

无需固定 IP,无需域名,无需服务器。一键生成临时公网链接:

你的电脑 localhost:5001
        ↓ Cloudflare Tunnel
https://abc-xyz.trycloudflare.com  ← 发给同事

使用流程:

  1. 安装 cloudflared(见下方)
  2. 确认 Agent 已启动
  3. 在"代理发布"页找到目标 Agent → 点击 生成链接
  4. 等待约 5–15 秒,出现 https://xxx.trycloudflare.com
  5. 复制链接发给同事
  6. 会后点 关闭,链接立即失效

安装 cloudflared:

# Windows(推荐用 Scoop)
scoop install cloudflared

# macOS
brew install cloudflared

或从 GitHub Releases 直接下载 exe。

⚠️ 临时链接无访问控制,请仅在需要时开启,会后立即关闭。

🛡️ Caddy 反向代理(长期发布)

适合需要固定域名、持续开放访问的场景:

  • 绑定自定义域名(自动申请 HTTPS 证书)
  • 用户名 / 密码访问控制(bcrypt 加密存储)
  • 多用户权限精细管理(每条规则可独立设置允许哪些用户访问)
  • 一键生成 Caddyfile + 启动/重载 Caddy

6️⃣ Port Manager — 端口管理

/port

查看当前机器上所有正在监听的端口:

  • 显示端口号、协议、PID、进程名
  • 一键终止占用指定端口的进程
  • 方便排查 Agent 启动失败(端口被占用)的问题

⚙️ 安装方式

下载预构建安装包(推荐)

从 Releases 下载最新版本:

平台文件
WindowsAgent-Manager.exe
macOS(Intel)Agent-Manager.dmg

双击安装包,按提示安装即可。

从源码构建

前置依赖:

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/ 下。


🚀 快速上手

第一步:添加 Agent

  1. 侧边栏点击 Agents → 右上角 + New Agent
  2. 点击 📁 选择 Agent 的项目目录
  3. 应用自动识别项目类型,填写启动命令
  4. 填写名称,确认端口号(有 Web UI 的 Agent 需要)→ 保存
  5. 点击 ▶ 启动

第二步:查看 Agent 界面

  • 有 Web UI 的 Agent(Streamlit / Flask 等):点击 Open UI → 在应用内嵌标签页打开
  • TUI 类 Agent(Claude Code 等):点击 Open Terminal → 在应用内嵌终端打开

第三步:使用 Manager Agent(可选)

  1. 在 MCP Agent → LLM 设置 中添加 LLM 提供商(见LLM 配置说明)
  2. 点击侧边栏 Manager
  3. 选择 LLM 提供商
  4. 用自然语言发送指令

第四步:开会时分享 Agent(可选)

  1. 安装 cloudflared
  2. 打开代理发布页面
  3. 找到目标 Agent → 生成链接 → 复制发送

🤖 LLM 配置说明

Manager Agent 和 MCP Agent 都需要 LLM 驱动。在 MCP Agent → LLM 设置 中添加:

字段说明示例
名称自定义,随便填DeepSeek
Base URLOpenAI 兼容的 API 地址https://api.deepseek.com/v1
API Key对应的 API Keysk-xxx
模型模型名称deepseek-chat

点击测试连接,显示绿色即配置成功。

内置支持的提供商:

提供商Base URL推荐模型
DeepSeekhttps://api.deepseek.com/v1deepseek-chat
OpenAIhttps://api.openai.com/v1gpt-4o-mini
任意兼容 API自定义自定义

🔍 支持的项目类型

选择项目目录后,自动检测并填写以下配置:

项目类型识别条件自动生成的命令
Python · uvpyproject.toml + uv.lockuv run python main.py
Python · FastAPIrequirements 含 fastapiuvicorn main:app --reload --port PORT
Python · Djangomanage.py 存在python manage.py runserver 0.0.0.0:8000
Python · Streamlitrequirements 含 streamlitstreamlit run app.py --server.port 8501
Python · Flaskrequirements 含 flaskpython app.py
Python · 通用main.py / app.py 等python main.py
Node.jspackage.jsonnpm run dev
RustCargo.tomlcargo run
Gogo.modgo run .
npm 全局命令%APPDATA%\npm\*.cmd交互式 PowerShell + 自动输入命令
可执行文件.exe / .bat / .cmd / .sh直接运行

端口号也会自动检测:扫描 .env 文件、pyproject.toml 脚本、源码中的 port= 配置。


📁 数据存储路径

数据WindowsmacOS
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 月

v0.2.0 主要更新

新功能:

  • ✅ 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)

❓ FAQ

  1. 前往 MCP Agent → LLM 设置,添加 LLM 提供商
  2. 点击"测试连接",确认绿色通过
  3. 回到 Manager 页面,在顶部下拉框选择该提供商

LLM 使用的是 Agent 的名称,确认你说的名称和 Agent 配置中的名称一致(支持模糊匹配,不区分大小写,也支持用下划线替代空格)。

这是 v0.2.0 已修复的问题。Manager Agent 组件始终在后台保持挂载,只是通过 CSS 隐藏。如果仍然消失,请确认使用的是 v0.2.0 版本。


查看 Agent 详情页的日志,通常是:

  • 端口被占用:在 Port Manager 找到占用该端口的进程并终止
  • 依赖未安装:在终端手动运行一次启动命令,查看具体报错
  • 工作目录不对:确认 Agent 配置中的工作目录路径正确

Agent 可能还在启动中(端口尚未监听)。等待几秒后,点击 UI 面板工具栏的刷新按钮。

这是正常现象。应用会自动启动 PowerShell,然后等待约 800ms 后向 stdin 写入 claude 命令。稍等 1–2 秒,Claude Code 的 TUI 界面会渲染出来。

自动识别基于文件扫描,边缘情况可能判断有误。在 Agent 编辑界面手动修改命令和参数即可,修改后保存立即生效。

可以。在 Agents 页面,按住 Agent 左侧的拖动把手(悬停后出现的 ⠿ 图标),拖拽到目标位置即可。顺序自动保存。


可能原因:

  1. cloudflared 未安装或不在 PATH 中 → 点击"重新检测"按钮,确认路径已识别
  2. 网络问题 → cloudflared 需要能访问 Cloudflare,确认没有代理或防火墙拦截
  3. Agent 未启动 → 临时链接会转发到本机端口,Agent 需处于运行状态

确认:

  1. Agent 在你本机正在运行(不是停止状态)
  2. 隧道还没有关闭(应用里还显示绿色 URL)
  3. 链接是完整的 https://xxx.trycloudflare.com 格式

这是 Agent 本身的限制,对话历史存在 Agent 进程的内存里,Agent Manager 无法从外部隔离。

如需隔离,需在 Agent 代码中加 session 支持(如 Streamlit 使用 st.session_state 天然隔离)。

安装 Caddy:

# Windows
scoop install caddy

# macOS
brew install caddy

安装后在代理发布页点击刷新按钮。


点击"更多信息" → "仍要运行"。这是因为安装包未经过 Microsoft 代码签名,属于正常现象。

在终端执行:

xattr -d com.apple.quarantine /Applications/智管-Agent\ Manager.app

或右键点击应用 → 选择"打开" → 再次点击"打开"。

本项目开发端口为 1420(避免与 Mindmap 等 Vite 项目的 5173 冲突)。如 1420 被占用:

# 查找占用进程
netstat -ano | findstr :1420
# 终止该进程(把 PID 替换为实际值)
taskkill /PID <PID> /F

🤝 参与贡献

欢迎提交 PR 或 Issue!


📄 License

Apache 2.0


⭐ 项目目标

把所有 Agent 的管理交给智管,把时间留给真正重要的事。

Ver o original no GitHub

Bom para

Relacionados