L1 只读
60 个工具
L1 只读有 60 个工具:查看状态、读文件、查询数据库,以及少数随时能撤回的轻操作,例如启用或停用一条已有的隧道、设置剪贴板。
直接执行。
- 调用仍要过三道检查:工具开关、机器可见范围、参数约束。
91 个工具分三级,高危操作要你本人的邮箱验证码。
Argus 提供 91 个 MCP 工具,每个工具按风险分为三级。等级写在服务端的工具注册表里,AI 助手不能改。
L1 60 个L2 15 个L3 16 个
60 个工具
L1 只读有 60 个工具:查看状态、读文件、查询数据库,以及少数随时能撤回的轻操作,例如启用或停用一条已有的隧道、设置剪贴板。
直接执行。
15 个工具
L2 可恢复有 15 个工具:改配置、建隧道、打包和解压文件、经 Agent 访问内网接口。
首次要邮箱验证码,之后默认 15 分钟内,同一个账号在同一台机器上用同一个工具直接通过。
16 个工具
L3 不可逆有 16 个工具:执行任意命令、写数据库、覆盖文件、点击和输入桌面界面(仅 Windows)、给 Agent 推送升级。
每一次都要新的验证码。
每个工具属于哪一级,都列在这里。可按级别筛选。
| 工具 | 分组 | 级别 | 做什么 |
|---|---|---|---|
list_agents | 机器与配置 | L1只读 | 列出你能看到的现场机器,可按工作组或类型过滤 |
list_agents_by_group | 机器与配置 | L1只读 | 列出某个工作组下的机器 |
list_agents_by_host_type | 机器与配置 | L1只读 | 列出某一类宿主机下的机器 |
list_groups | 机器与配置 | L1只读 | 列出你能看到的工作组和各组机器数 |
list_host_types | 机器与配置 | L1只读 | 列出宿主机类型和各类机器数 |
get_agent_metrics | 机器与配置 | L1只读 | 读一台机器最近一次的 CPU、内存、磁盘、GPU 数据 |
get_agent_metrics_history | 机器与配置 | L1只读 | 读一台机器的历史性能指标曲线 |
get_agent_config | 机器与配置 | L1只读 | 读一台机器的功能开关和各类预设,凭证打码 |
configure_agent_preset | 机器与配置 | L2可恢复 | 新增或修改一条 Web、SQL 或 S3 预设 |
remove_agent_preset | 机器与配置 | L2可恢复 | 删除一条 Web、SQL 或 S3 预设 |
set_agent_features | 机器与配置 | L2可恢复 | 修改一台机器的功能开关和性能采集配置 |
run_safe_command | 命令与进程 | L1只读 | 执行白名单里的常用只读命令 |
job_status | 命令与进程 | L1只读 | 查询后台任务的运行状态 |
job_tail | 命令与进程 | L1只读 | 读后台任务输出的末尾若干行 |
list_process_tree | 命令与进程 | L1只读 | 列出进程及其父子关系 |
job_cancel | 命令与进程 | L2可恢复 | 终止一个正在运行的后台任务 |
run_command | 命令与进程 | L3不可逆 | 在机器上执行任意 shell 命令 |
job_start | 命令与进程 | L3不可逆 | 把命令作为后台任务启动,立即返回任务号 |
kill_process_tree | 命令与进程 | L3不可逆 | 结束一个进程和它的整棵子进程树 |
list_files | 文件 | L1只读 | 列出机器上某个目录的文件和子目录 |
read_file | 文件 | L1只读 | 读取文件内容,可按字节切片 |
grep_file | 文件 | L1只读 | 在单个文件里按正则逐行搜索,适合大日志 |
file_search | 文件 | L1只读 | 按文件名通配符递归查找文件 |
get_transfer_status | 文件 | L1只读 | 查询一笔文件传输的当前状态 |
download_file | 文件 | L1只读 | 把小文件以 base64 取回给 AI 助手分析 |
upload_to_sandbox | 文件 | L2可恢复 | 把小文件上传到机器上固定的沙盒目录 |
archive_file | 文件 | L2可恢复 | 把一个或多个路径打包成 zip 或 tar.gz |
unarchive_file | 文件 | L2可恢复 | 解压 zip 或 tar.gz 归档,自动识别分卷 |
upload_file | 文件 | L3不可逆 | 把文件上传到机器上的指定路径 |
execute_select | 数据库 | L1只读 | 执行只读 SQL,如 SELECT、SHOW、EXPLAIN |
execute_sql | 数据库 | L3不可逆 | 执行任意 SQL,包括写入和改表结构 |
proxy_api_get | 内网接口 | L1只读 | 经 Agent 代发 GET 请求,受 URL 白名单约束 |
proxy_api | 内网接口 | L2可恢复 | 经 Agent 访问现场内网的 HTTP 接口 |
list_tunnels | 端口隧道 | L1只读 | 列出隧道及其状态、目标地址和监听端口 |
toggle_tunnel | 端口隧道 | L1只读 | 启用或停用一条已有的隧道 |
tunnel_stats | 端口隧道 | L1只读 | 读取隧道的实时流量统计 |
create_tunnel | 端口隧道 | L2可恢复 | 创建一条隧道:端口映射或机器间直连 |
update_tunnel | 端口隧道 | L2可恢复 | 修改一条隧道的配置 |
delete_tunnel | 端口隧道 | L2可恢复 | 删除一条隧道 |
set_agent_direct_listen | 端口隧道 | L2可恢复 | 设置机器用于直连隧道的监听端口 |
screenshot | 桌面操作仅 Windows | L1只读 | 截取桌面全屏缩略图或指定区域原图 |
wait_stable | 桌面操作仅 Windows | L1只读 | 等屏幕画面稳定后返回缩略图 |
scroll | 桌面操作仅 Windows | L1只读 | 在指定位置滚动鼠标滚轮 |
get_clipboard | 桌面操作仅 Windows | L1只读 | 读取剪贴板内容 |
set_clipboard | 桌面操作仅 Windows | L1只读 | 设置剪贴板文本 |
get_screen_info | 桌面操作仅 Windows | L1只读 | 读取屏幕分辨率、DPI 和缩放比例 |
get_ui_elements | 桌面操作仅 Windows | L1只读 | 读取指定区域的界面元素树 |
ui_snapshot | 桌面操作仅 Windows | L1只读 | 列出目标窗口里当前可操作的界面元素 |
ui_wait | 桌面操作仅 Windows | L1只读 | 等某个界面元素出现、消失或变为可用 |
read_pixels | 桌面操作仅 Windows | L1只读 | 按物理像素读取一块区域的颜色值 |
get_machine_presence | 桌面操作仅 Windows | L1只读 | 查看机器前是否有人、是否正被别的 AI 助手操作 |
restore_display_scale | 桌面操作仅 Windows | L1只读 | 把改过的显示缩放恢复为原值 |
click | 桌面操作仅 Windows | L3不可逆 | 在指定坐标单击鼠标 |
double_click | 桌面操作仅 Windows | L3不可逆 | 在指定坐标双击鼠标 |
right_click | 桌面操作仅 Windows | L3不可逆 | 在指定坐标右键单击 |
drag | 桌面操作仅 Windows | L3不可逆 | 按住左键从一点拖到另一点 |
type_text | 桌面操作仅 Windows | L3不可逆 | 用键盘输入一段文本 |
key | 桌面操作仅 Windows | L3不可逆 | 按下一个按键或组合键 |
ui_act | 桌面操作仅 Windows | L3不可逆 | 按界面元素引用执行点击、输入等动作 |
set_display_scale | 桌面操作仅 Windows | L3不可逆 | 修改某块屏幕的显示缩放 |
computer_batch | 桌面操作仅 Windows | L3不可逆 | 一次审批,顺序执行一串桌面动作,最多 20 步 |
browser_snapshot | 网页操作 | L1只读 | 读取浏览器里网页的可操作元素或正文 |
browser_screenshot | 网页操作 | L1只读 | 截取网页视口画面,不受窗口遮挡影响 |
browser_navigate | 网页操作 | L2可恢复 | 让标签页打开网址,或后退、前进、刷新 |
browser_act | 网页操作 | L3不可逆 | 按元素引用点击、输入等,操作网页元素 |
list_host_software | 现场软件的 MCP 接口 | L1只读 | 列出各现场接入的三方软件 MCP 及在线状态 |
describe_host_software | 现场软件的 MCP 接口 | L1只读 | 对比同一软件在各现场的版本和工具清单 |
configure_host_software | 现场软件的 MCP 接口 | L2可恢复 | 新增或修改一条三方软件 MCP 服务配置 |
remove_host_software | 现场软件的 MCP 接口 | L2可恢复 | 删除一条三方软件 MCP 服务配置 |
list_agent_versions | Agent 版本 | L1只读 | 列出已上传的 Agent 版本包 |
list_update_records | Agent 版本 | L1只读 | 查询 Agent 升级推送记录 |
push_agent_update | Agent 版本 | L3不可逆 | 把指定版本包推送给逐台列出的 Agent 升级 |
list_inspect_skills | 巡检与告警 | L1只读 | 列出巡检 Skill |
get_inspect_skill | 巡检与告警 | L1只读 | 读取一条巡检 Skill 的全文 |
create_inspect_skill | 巡检与告警 | L1只读 | 新建一条巡检 Skill |
update_inspect_skill | 巡检与告警 | L1只读 | 修改一条巡检 Skill |
delete_inspect_skill | 巡检与告警 | L1只读 | 删除一条巡检 Skill,需显式确认 |
list_alert_rules | 巡检与告警 | L1只读 | 列出告警规则 |
get_alert_rule | 巡检与告警 | L1只读 | 读取一条告警规则的全文 |
list_maintenance_windows | 巡检与告警 | L1只读 | 列出维护静默窗口 |
list_inspect_tasks | 巡检与告警 | L1只读 | 列出 AI 巡检任务 |
get_inspect_task | 巡检与告警 | L1只读 | 读取一个巡检任务的全文 |
list_inspect_runs | 巡检与告警 | L1只读 | 列出巡检和告警分析的运行记录 |
get_inspect_run | 巡检与告警 | L1只读 | 读取一次巡检运行的结论和发现项 |
list_alert_events | 巡检与告警 | L1只读 | 列出告警事件,可按状态和机器过滤 |
create_alert_rule | 巡检与告警 | L1只读 | 新建一条告警规则 |
update_alert_rule | 巡检与告警 | L1只读 | 修改一条告警规则 |
create_inspect_task | 巡检与告警 | L1只读 | 新建一个 AI 巡检任务 |
update_inspect_task | 巡检与告警 | L1只读 | 修改一个 AI 巡检任务 |
delete_inspect_task | 巡检与告警 | L1只读 | 删除一个巡检任务,需显式确认 |
ack_alert_event | 巡检与告警 | L1只读 | 确认或手动恢复一条告警事件 |
管理员可按工作组限制工具和参数:路径黑名单、SQL 禁用关键字、URL 白名单。
*.env、*.key、*.pem。DROP、TRUNCATE;还可以限定只能用哪几个数据源预设。一条记录包含:操作者、Key、工具、参数摘要、结果(成功、出错或被拒绝)、耗时和时间。
支持 MCP 协议的客户端都可以接入,包括 Claude Code、Claude Desktop 和 Cursor。
# 地址换成你自己的服务器
$ claude mcp add --transport http argus http://你的服务器地址:8080/api/mcp 验证码发到操作者本人的邮箱。建议不要把这个邮箱接入同一个 AI 助手的工具集。
不能。批准后按服务端保存的原始参数执行,AI 助手事后改参数无效。
让 AI 助手重新发起这次调用,服务器会发一个新的验证码。L2 的验证码 15 分钟内有效,L3 的 5 分钟内有效。
管理员在「工具权限」里把这个工具对相应的工作组关掉。关掉以后,这个工作组的成员和他们的 AI 助手都不能调用它。