mcpField
C
cli-anything-jumpserver

cli-anything-jumpserver

github.com/hkuds安全57.6k204 次安装5 周前更新
代码仓库

关于 cli-anything-jumpserver

通过 REST API 管理 JumpServer 堡垒机的有状态 CLI 工具，面向 AI Agent 工作流。它支持 JSON 输出，并可在修改资产、用户、权限、会话和审计记录前进行模拟预览。

主要功能

  1. 01管理资产、用户和权限
  2. 02查看会话与审计记录
  3. 03通过 JumpServer 进行身份验证
  4. 04支持 JSON 和 YAML 输出
  5. 05使用 dry-run 预览变更

适用场景

  1. 01盘点主机并查看资产详情
  2. 02创建用户并授予资产访问权限
  3. 03审查失败登录和活动会话

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-jumpserver

安装后在 Claude Code 中输入/cli-anything-jumpserver确认已加载。

详细介绍

cli-anything-jumpserver

用于 JumpServer 堡垒机的有状态 CLI 封装工具。通过 JumpServer REST API 管理资产、用户、权限、账号、会话、审计等。

快速开始

# Install
cd agent-harness && pip install -e .

# Authenticate
cli-anything-jumpserver auth login --url https://jumpserver.example.com --username admin

# List hosts
cli-anything-jumpserver asset list --type host

# Interactive REPL mode
cli-anything-jumpserver --interactive

Agent 使用指南

本 CLI 专为 AI Agent 使用而设计。面向 Agent 的关键特性：

JSON 输出模式

所有命令均支持 --output json，以输出可由机器解析的结果：

cli-anything-jumpserver asset list --type host --output json
试运行模式

所有变更类命令均支持 --dry-run，可在不执行的情况下预览：

cli-anything-jumpserver asset create --name test --address 10.0.0.1 --platform 1 --dry-run --output json
环境变量
  • JUMPSERVER_URL - 默认 JumpServer URL
  • JUMPSERVER_USERNAME - 默认用户名
  • JUMPSERVER_PASSWORD - 默认密码
典型 Agent 工作流

1. 发现与盘点

# Check connection
cli-anything-jumpserver auth status --output json

# List all hosts
cli-anything-jumpserver asset list --type host --output json

# Get asset details
cli-anything-jumpserver asset get <ID> --type host --output json

# List all users
cli-anything-jumpserver user list --output json

2. 用户与权限管理

# Create user
cli-anything-jumpserver user create --name "New User" --username newuser --email [email protected] --output json --dry-run

# Grant asset access
cli-anything-jumpserver perm create --name "App Access" --users "user1,user2" --assets "asset1,asset2" --output json --dry-run

# Verify permissions
cli-anything-jumpserver perm users <PERM_ID> --output json

3. 安全审计

# Check failed logins
cli-anything-jumpserver audit login --status failed --output json

# Review operations
cli-anything-jumpserver audit operate --action delete --output json

# Check active sessions
cli-anything-jumpserver session list --active --output json

# View command history
cli-anything-jumpserver session command list --risk 5 --output json

4. 会话管理

# Monitor active sessions
cli-anything-jumpserver session list --active --output json

# Check terminal health
cli-anything-jumpserver session terminal list --output json
cli-anything-jumpserver session terminal status <TERMINAL_ID> --output json

输出格式

格式标志使用场景
Table--output table（默认）便于人工阅读的显示
JSON--output jsonAgent 使用、编写脚本
YAML--output yaml配置、可读性

退出码

代码含义
0成功
1CLI 错误（认证、API 等）
2用法错误（无效选项/参数）
130已中断（Ctrl+C）

文件位置

路径用途
~/.jumpserver-cli/session.json认证会话
~/.jumpserver-cli/state.jsonCLI 运行状态

评论

支持 Markdown