MCP server de XOps CLI
Commit 13 nov 2026Permite que un cliente de IA ejecute comandos SSH, transfiera archivos y gestione hosts mediante un MCP server integrado con controles de aprobación y auditoría.
También conocido como wentf9/xops-cli
- Stars
- 22
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 13 nov 2026
- Licencia
- MIT
¿Qué es XOps CLI MCP?
XOps CLI es un MCP server. Permite que un cliente de IA ejecute comandos SSH, transfiera archivos y gestione hosts mediante un MCP server integrado con controles de aprobación y auditoría.
Resumen generado a partir del README del proyecto
Acerca del MCP server de XOps CLI
Gestionar infraestructura remota y ejecutar comandos a través de clientes de IA es lo que xops-cli permite a ingenieros de DevOps y administradores de sistemas. Este binario de Go multiplataforma ofrece una forma centralizada de manejar conexiones SSH, transferencias de archivos SFTP y ejecución de comandos por lotes en entornos heterogéneos, como contenedores Alpine o nodos Windows OpenSSH. Funciona como una herramienta local que puede integrarse en clientes como Claude Desktop, Cursor o Codex mediante un MCP server integrado usando modos de transporte stdio o HTTP.
Los usuarios pueden gestionar hosts mediante etiquetas y ejecutar tareas en paralelo a través de Playbooks en YAML que admiten pasos idempotentes como ensure. El servidor incluye salvaguardas de seguridad como el análisis de riesgo de comandos, formularios de aprobación interactivos para operaciones de alto riesgo y protección de rutas. Las credenciales se cifran y se almacenan localmente en un directorio dedicado, garantizando que las contraseñas sensibles o las claves privadas nunca se guarden en texto plano. La herramienta también cuenta con una TUI para la gestión interactiva y una Agent Skill especializada para la operación directa en la terminal.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblewentf9/xops-cli is public and reachablegithub.com/wentf9/xops-cli ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-13github.com/wentf9/xops-cli ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubXOps CLI
日常运维和基础设施管理中,你是否经常在这些工具之间来回切换:
- 手写
~/.ssh/config,或者为了免输密码冒险使用sshpass把明文密码留在 Shell 历史里? - 面对几十台机器时,觉得搭一套 Ansible / Python 环境太重,只想要一个单文件二进制并行跑命令、传文件、做状态收敛?
- 连上 Alpine 容器(无 Bash)、Windows OpenSSH(CMD / PowerShell)或 fish/zsh 节点时,脚本总是因为 Shell 方言不兼容而报错?
- 想让 Claude、Codex、Cursor 等 AI 助手帮你排查和运维服务器,又担心放开权限后 AI 误执行高危命令?
XOps CLI 将这些能力收敛进一个跨平台 Go 二进制文件中:零远端依赖、凭据默认本机加密存储、自动探测目标 Shell 环境,同时原生提供带风险护栏与审批审计的 MCP 服务端和 AI Agent Skill。
⚡ 30 秒极速上手
# 1. 一键安装(Linux / macOS)
curl -fsSL https://raw.githubusercontent.com/wentf9/xops-cli/master/install.sh | bash
# Windows 在 PowerShell 5.1+ 中安装(支持 x64 / ARM64,无需管理员权限):
irm https://raw.githubusercontent.com/wentf9/xops-cli/master/install.ps1 | iex
# 2. 导入现有的 ~/.ssh/config(纯本地读取,不连远端,不覆盖已有节点)
xops init
# 3. 直接连接任意主机 —— 首次验证成功后自动保存节点,并将密码/口令加密存入本机凭据库
xops ssh root@192.0.2.10
# 4. 打开交互式终端管理面板(SSH 会话、实时系统监控、远端日志搜索、标签管理)
xops tui
从源码编译(需 Go 1.26+,Makefile 原生支持 Linux、macOS 与 Windows):
git clone https://github.com/wentf9/xops-cli.git && cd xops-cli && make build # Windows 下自动生成 bin/xops.exe;任意平台均可执行 make windows 交叉编译
✨ 为什么选择 XOps CLI?
| 痛点场景 | XOps CLI 的解决方案 |
|---|---|
| 密码管理繁琐且不安全 | 验证一次,加密记住:首次连接认证通过后,登录密码、私钥口令和 sudo/su 密码自动加密保存在本机 ~/.xops/credentials/(亦支持系统原生 Keychain、pass 或自定义 helper),YAML 配置中绝不出现明文密码。 |
| 异构环境与无 Bash 容器报错 | 零远端依赖 + 自动 Shell 探针:默认 server 直通模式不依赖远端预装 Bash;首次添加/连接节点时复用同一 SSH 连接自动探测外层方言(posix/fish/cmd/powershell)与可用解释器(bash/sh/zsh/fish/powershell/pwsh/cmd),Alpine 与 Windows OpenSSH 开箱即用。 |
| 交互式与批量运维割裂 | 从 1 台无缝扩展到 100 台:同一套主机与凭据资产,既能用 xops ssh、xops tui、xops sftp 交互操作,也能用 xops exec --tag web、xops scp --tag web 并行批处理。 |
| 轻量级部署无需重型编排 | 声明式 YAML Playbook:内置 shell、script、copy、template 和幂等收敛步骤 ensure(check → action → 复查);严格区分远程执行结果三态(not_started / completed / unknown),断连结果未知时绝不盲目重试。 |
| AI 自动化缺乏安全护栏 | 双模 AI 接入(MCP + Agent Skill):内置 MCP 服务端(支持 stdio 与局域网 Streamable HTTP),自带命令风险分析、交互式审批(Elicitation)、路径保护与操作审计;或直接安装 xops-agent Skill 让 AI 操作 CLI。 |
🛠️ 核心功能一览
1. 主机资产、自动探针与加密凭据
XOps 将网络地址(Host)、认证身份(Identity)与连接节点(Node)解耦管理,同一 IP 可关联多个不同权限的账户:
# 从 CSV 批量导入主机并打上 web 标签(默认验证 SSH 连接并自动探测保存远端 Shell 配置)
xops host import hosts.csv --tag web
# 手动添加单台主机
xops host add --address 192.0.2.10 --user deploy --key ~/.ssh/id_ed25519 --alias web-01 --tags web
# 查看主机列表、标签,或诊断节点的远端 OS 与可用解释器
xops host list
xops host probe web-01
xops host probe --all --save
# 检查凭据存储健康状态
xops credential store list
xops credential doctor
- 先验证后入库:
ssh、sftp、scp、exec首次连接新主机时,仅在 SSH 握手与认证成功后才保存节点;连接超时或密码错误不会留下垃圾记录。 - 灵活的保存策略:单次连接可加
--remember never禁止记住密码,或在配置中设置credential.remember_prompted: ask | never。离线添加或导入可使用--skip-verify(或--no-probe跳过 Shell 探针)。 - 详见:主机与身份 · 凭据存储 · 离线凭据库 · 凭据迁移
2. 增强型 SSH、提权与交互式 SFTP
# 通过别名快速登录,或以其他用户连接同一台主机(自动复用 Host 并隔离凭据)
xops ssh web-01
xops ssh audit@web-01
# 跳板机穿透(支持多级 ProxyJump、直连 IP/FQDN 或已保存的节点别名)
xops ssh -J bastion.example.com -i ~/.ssh/id_rsa root@192.0.2.13
# 免开放 root SSH 登录:普通用户连接后自动完成 sudo / sudo-rs / su 提权握手
xops ssh --sudo web-01
xops exec -x --sudo web-01 id
# 端口转发与 SOCKS5 动态代理(内置智能心跳保活与断线自动清理)
xops ssh -L 8080:127.0.0.1:80 -D 1080 -N web-01
# 交互式 SFTP 终端(支持 Tab 跨页路径补全、Ctrl+R 历史搜索、当前远端目录下 exec 命令)
xops sftp web-01
- 详见:SSH 与提权 · SFTP 与文件传输 · 终端管理界面 (TUI)
3. 并行批量执行与 YAML Playbook
# 对 web 标签组的所有主机并行执行命令(排除维护节点)
xops exec --tag web --exclude web-maint-01 -c "uptime"
# 并发分发并执行本地脚本(并发度 5)
xops exec --tag web --shell ./setup.sh --task 5
# 批量分发配置文件到目标服务器群
xops scp --tag web ./config.conf /etc/app/
使用 YAML 编写声明式 Playbook(deploy.yaml),实现幂等部署:
name: deploy-web
targets:
tags: [web]
settings:
concurrency: 2
on_error: stop # 可选 stop | abort_all | continue
vars:
app_port: "8080"
steps:
- name: "确保 nginx 已安装"
ensure:
check: "nginx -v"
action: "apt-get update && apt-get install -y nginx"
sudo: true
- name: "渲染并分发配置"
template:
src: "./nginx.conf.tmpl"
dest: "/etc/nginx/nginx.conf"
sudo: true
- name: "启动 nginx 服务"
shell: "systemctl restart nginx"
sudo: true
# 预览执行计划(Dry Run)与正式运行
xops play deploy.yaml --dry-run
xops play deploy.yaml --var app_port=8081 --limit web-01
- 详见:命令执行 · Playbook 与自动化
4. AI 接入:MCP 服务端 & Agent Skill
XOps 提供两种互补的 AI 接入方式,适配不同客户端:
方式 A:内置 MCP 服务端(Claude Desktop / Cursor / Codex / Antigravity)
# 本地 stdio 模式启动(提供节点查询、命令执行、SFTP 文件读写与 -L/-R SSH 隧道工具)
xops mcp serve
# 局域网 Streamable HTTP 模式启动(支持 Bearer Token 认证与 10 GiB 级流式文件上下传)
xops mcp serve --transport http --listen 0.0.0.0:8080 \
--public-url http://192.168.1.10:8080 --token-file ~/.xops/mcp.token
在 claude_desktop_config.json 中接入:
{
"mcpServers": {
"xops": {
"command": "/usr/local/bin/xops",
"args": ["mcp", "serve"]
}
}
}
- 内置安全护栏(Guardrail):自动评估命令与路径风险,高风险操作触发客户端交互式审批表单,审批期间若目标配置被篡改则自动废止许可,并完整记录审计日志。
- 详见:MCP HTTP 与文件传输 · MCP SSH 隧道
方式 B:xops-agent Skill(让 AI 直接在终端操作 CLI)
无需启动 MCP 服务,一行命令为支持 Skill 的 Agent 安装 xops-agent 操作规范:
npx skills add https://github.com/wentf9/xops-cli --skill xops-agent
手工安装可直接复制 skills/xops-agent/ 目录(保留 SKILL.md 与 references/)。详见 Agent Skill 指南。
📄 开源协议
本项目基于 MIT License 开源。如果 XOps CLI 帮到了你的日常运维或 AI 工作流,欢迎点亮一颗 Star ⭐ 支持项目发展!
Preguntas sobre XOps CLI MCP
¿Cómo conecto el XOps MCP server a Claude Desktop?
Configura el binario de xops como el comando con los argumentos "mcp serve" en tu archivo claude_desktop_config.json bajo la sección mcpServers.
¿El XOps MCP server admite transporte HTTP?
Sí, ejecuta xops mcp serve con --transport http y una dirección de escucha; admite autenticación mediante Bearer Token y transferencias de archivos grandes por streaming.
¿Qué controles de seguridad tiene el XOps MCP server?
Evalúa el riesgo de comandos y rutas, activa aprobaciones interactivas para operaciones de alto riesgo y registra logs de auditoría; las aprobaciones se revocan si cambia la configuración del objetivo.
¿Qué herramientas expone el XOps MCP server?
Proporciona consultas de nodos, ejecución de comandos, lectura/escritura de archivos vía SFTP y herramientas de túnel SSH -L/-R.
¿Pueden los agentes de IA usar XOps sin MCP?
Sí, instala la Skill xops-agent para que el agente opere la CLI directamente en la terminal.