XOps CLI MCP sunucusu
Commit 13 Kas 2026Yerleşik bir MCP server aracılığıyla bir AI istemcisinin SSH komutları çalıştırmasına, dosya aktarmasına ve host yönetimini onay ve denetim mekanizmalarıyla gerçekleştirmesine olanak tanır.
Ayrıca bilinen adı wentf9/xops-cli
- Yıldızlar
- 22
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 13 Kas 2026
- Lisans
- MIT
XOps CLI MCP nedir?
XOps CLI bir MCP sunucusudur. Yerleşik bir MCP server aracılığıyla bir AI istemcisinin SSH komutları çalıştırmasına, dosya aktarmasına ve host yönetimini onay ve denetim mekanizmalarıyla gerçekleştirmesine olanak tanır.
Özet, projenin README dosyasından oluşturuldu
XOps CLI MCP sunucusu hakkında
xops-cli, DevOps mühendisleri ve sistem yöneticileri için uzaktaki altyapıları yönetmeyi ve AI istemcileri üzerinden komut çalıştırmayı mümkün kılar. Bu platformlar arası Go binary dosyası; Alpine konteynerleri veya Windows OpenSSH düğümleri gibi heterojen ortamlarda SSH bağlantılarını, SFTP dosya transferlerini ve toplu komut yürütme işlemlerini merkezi bir şekilde yönetmenizi sağlar. stdio veya HTTP transport modlarını kullanan yerleşik bir MCP server aracılığıyla Claude Desktop, Cursor veya Codex gibi istemcilere entegre edilebilen yerel bir araç olarak çalışır.
Kullanıcılar, etiketleri kullanarak hostları yönetebilir ve ensure gibi idempotent adımları destekleyen YAML Playbook'lar aracılığıyla paralel görevler yürütebilirler. Server; komut risk analizi, yüksek riskli işlemler için etkileşimli onay formları ve yol koruması gibi güvenlik bariyerleri içerir. Kimlik bilgileri şifrelenerek özel bir dizinde yerel olarak saklanır; böylece hassas parolaların veya özel anahtarların asla düz metin olarak tutulmaması sağlanır. Araç ayrıca etkileşimli yönetim için bir TUI ve doğrudan terminal operasyonları için özelleşmiş bir agent skill özelliğine sahiptir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirwentf9/xops-cli is public and reachablegithub.com/wentf9/xops-cli ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-13github.com/wentf9/xops-cli ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
XOps 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 ⭐ 支持项目发展!
XOps CLI MCP soruları
XOps MCP server'ı Claude Desktop'a nasıl bağlarım?
claude_desktop_config.json dosyanızdaki mcpServers bölümünde, xops binary dosyasını args "mcp serve" parametresiyle birlikte komut olarak ayarlayın.
XOps MCP server HTTP transport destekliyor mu?
Evet, xops mcp serve komutunu --transport http ve bir dinleme adresi ile çalıştırabilirsiniz; Bearer Token kimlik doğrulaması ve büyük akışlı dosya transferlerini destekler.
XOps MCP server hangi güvenlik kontrollerine sahiptir?
Komut ve yol riskini değerlendirir, yüksek riskli işlemler için etkileşimli onay mekanizmasını tetikler ve denetim günlükleri tutar; hedef yapılandırma değişirse onaylar iptal edilir.
XOps MCP server hangi araçları sunar?
Node sorguları, komut çalıştırma, SFTP dosya okuma/yazma ve -L/-R SSH tünel araçları sağlar.
AI agent'lar XOps'u MCP olmadan kullanabilir mi?
Evet, agent'ın terminalde doğrudan CLI kullanabilmesi için xops-agent Skill paketini yükleyebilirsiniz.