WorkBuddy + Jumpserver MCP做智能运维助手

Jumpserver MCP 与 WorkBuddy 集成价值

对于小公司来说，如果机器总数只有几十台，配个 Jumpserver 又安全又高效，尤其是接入 AI 之后效率会更高。做什么事只要跟 AI 下个指令，它自动就帮你搞定！

老早就用过 Jumpserver MCP 了，虽然是官方提供的，但很久都没有更新过。最大的问题就是工具太多，800 多个，如果一股脑给到 AI，会有两个问题：一是上下文太多，Token 消耗会很大；二是严重影响做事效率。

最近我改进了验证机制：之前用临时 Token，一天就过期，现在换成了永久 Token；另外 MCP 客户端和服务端的验证，走独立的 api_key。最新代码已经更新到 github 了。

早期我整理 Dify + Jumpserver MCP 时，并没有搞定登录远程机器执行命令，这次我借助 WorkBuddy 实现了。下面整理下要点。

环境准备与认证配置

要想用这套东西，首先你得搭建好 Jumpserver，版本要 4.x，老的没测，估计不兼容。然后根据项目里的 README 编译最新的 docker images，最后把容器启起来。

还有一个很重要的点：定义 .env 配置文件时，要有三个东西。

jumpserver_url=http://<jumpserver-host>
api_token=<JumpServer private token>
api_key=<your-custom-token>

最下面这个 api_key 需要你自己自定义。

其中永久的 api_token 这样获取，先进 jms_core 容器，再进 Django shell。

docker exec -it jms_core bash
cd /opt/jumpserver/apps
python manage.py shell

在 shell 里执行这几行：

from users.models import User
u = User.objects.get(username='admin_api')
u.create_private_token() ## 首次创建用这个

拿到的就是长期有效的 token，不会一天就过期。

精简工具集至 13 个核心能力

既然问题出在工具数量上，那配置的时候就没必要全给。这套 MCP 我只配了 13 个工具，按用途分成四组：资产 5 个、用户 3 个、授权 2 个、执行 3 个。

这 13 个基本覆盖了查资产 → 建用户 → 给授权 → 跑命令的完整链路，其余那 800 来个在 AI 手里基本用不上。

四条可复用的标准工作流

下面这四条 SOP，可以直接定义到 prompt 或者 skill 里，让 AI 照着走，不用每次重新解释一遍。

SOP 01：远程执行命令

这是最常用的一条，五步走完。

1. settings_public_retrieve → 确认 SECURITY_COMMAND_EXECUTION == true，是 false 就直接停，别白跑一趟。
2. assets_hosts_list(q=名称或 address) → 拿资产 uuid。
3. ops_jobs_create（module、args、assets，is_periodic:false、instant:true、run_after_save:true）。
4. ops_job_execution_task_detail_retrieve(task_id) → 轮询直到 is_finished。
5. ops_ansible_job_execution_log_retrieve(task_id) → 取 stdout 回复用户。

这条路上有几个特别容易误判的现象，先记下来：

SOP 02：创建用户并授权

1. users_users_list(username=xxx) → 查重，已存在就跳到第 4 步。
2. users_users_create(name, username, email) ← 这里不传密码。
3. users_users_password_partial_update(id, password) → 密码单独设。
4. assets_nodes_list(q=部门名) 或 assets_hosts_list 逐个取 id。
5. perms_asset_permissions_list(name=xxx) → 查重。
6. perms_asset_permissions_create(name, users, nodes/assets, accounts:[], protocols:["all"], actions)

SOP 03：纳管新主机

1. assets_hosts_list(address=目标 IP) → 查重，已存在就停。
2. assets_platforms_list(name__startswith=Linux) → 平台 id。
3. assets_nodes_list(q=节点名) → 节点 id。
4. assets_hosts_create(name, address, platform{id,name}, nodes[{id,name}])

第 5 步别忘了提示用户：资产已经纳管，但还得在这个资产上添加账号，才能登录或者执行命令。

SOP 04：盘点与巡检

1. assets_hosts_list(limit=100) → 注意 count 与已返回条数，必要时翻页。
2. assets_databases_list（如需要）另算一类资产。
3. users_users_list(limit=100)
4. perms_asset_permissions_list(limit=100) → 列表里 users/assets 常是空数组，得逐个 retrieve 取详情。

批量命令执行权限必须显式开启

要想通过 Jumpserver MCP 到主机上执行命令，必须先把批量命令执行的权限打开，否则会被拒。

这个开关不开，SOP-1 走到执行那一步就会被直接拒掉。

路径：功能设置 → 作业中心 → 勾选批量命令执行