자연어를 통해 명령 실행, 파일 관리 및 Docker 오케스트레이션을 수행하며 AI 모델이 원격 서버를 관리할 수 있도록 지원합니다.
다른 이름 Echoqili/ssh-licco, ssh-licco
- 스타
- 4
- Tools
- —
- 다운로드, 30일
- 425
- 최신 버전
- 2.7.3
- 마지막 커밋
- 2026년 10월 26일
- 라이선스
- MIT
SSH LICCO MCP란?
SSH LICCO은(는) MCP server입니다. 자연어를 통해 명령 실행, 파일 관리 및 Docker 오케스트레이션을 수행하며 AI 모델이 원격 서버를 관리할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
SSH LICCO MCP server 정보
SSH LICCO는 AI 모델이 자연어를 사용하여 원격 서버를 관리할 수 있게 해주는 MCP server입니다. 사용자는 대화형 인터페이스를 통해 명령을 실행하고, 파일을 관리하며, Docker 컨테이너를 오케스트레이션할 수 있습니다. 이 서버는 표준 SSH 및 SFTP 프로토콜을 통해 Linux, macOS, Windows Server 대상을 지원합니다. 서버 명령과 환경 변수를 설정하여 Claude Desktop, Cursor 또는 Trae와 같은 클라이언트에 통합할 수 있습니다.
보안은 핵심 요소로, STRICT, BALANCED, RELAXED의 세 가지 보호 수준을 제공합니다. 시스템에는 루트 디렉토리의 재귀적 삭제나 디스크 포맷팅과 같은 치명적인 명령을 무조건 차단하는 하드코딩된 보호 기능이 포함되어 있습니다. 사용자는 비밀번호, 키, 에이전트 포워딩을 포함한 다양한 인증 방법을 사용하여 연결을 관리할 수 있습니다. 또한 서버는 screen 또는 tmux를 위한 ssh_session 및 전체 컨테이너 라이프사이클 관리를 위한 ssh_docker와 같은 도구를 통해 고급 세션 관리 기능을 제공합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
SSH LICCO MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 SSH LICCO MCP 설치
$ claude mcp add --env 'SSH_HOST=<SSH_HOST>' --env 'SSH_USER=<SSH_USER>' --env 'SSH_PASSWORD=<YOUR_SSH_PASSWORD>' ssh-licco -- uvx ssh-liccoCursor에 SSH LICCO MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"ssh-licco": {
"command": "uvx",
"args": [
"ssh-licco"
],
"env": {
"SSH_HOST": "<SSH_HOST>",
"SSH_USER": "<SSH_USER>",
"SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
}
}
}
}VS Code에 SSH LICCO MCP 설치
.vscode/mcp.json
{
"servers": {
"ssh-licco": {
"type": "stdio",
"command": "uvx",
"args": [
"ssh-licco"
],
"env": {
"SSH_HOST": "<SSH_HOST>",
"SSH_USER": "<SSH_USER>",
"SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
}
}
}
}VS Code CLI에 SSH LICCO MCP 설치
$ code --add-mcp '{"name":"ssh-licco","type":"stdio","command":"uvx","args":["ssh-licco"],"env":{"SSH_HOST":"<SSH_HOST>","SSH_USER":"<SSH_USER>","SSH_PASSWORD":"<YOUR_SSH_PASSWORD>"}}'Claude Desktop에 SSH LICCO MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"ssh-licco": {
"command": "uvx",
"args": [
"ssh-licco"
],
"env": {
"SSH_HOST": "<SSH_HOST>",
"SSH_USER": "<SSH_USER>",
"SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
}
}
}
}Codex에 SSH LICCO MCP 설치
$ codex mcp add ssh-licco --env 'SSH_HOST=<SSH_HOST>' --env 'SSH_USER=<SSH_USER>' --env 'SSH_PASSWORD=<YOUR_SSH_PASSWORD>' -- uvx ssh-liccoCodex config.toml에 SSH LICCO MCP 설치
~/.codex/config.toml
[mcp_servers.ssh-licco] command = "uvx" args = ["ssh-licco"] [mcp_servers.ssh-licco.env] SSH_HOST = "<SSH_HOST>" SSH_USER = "<SSH_USER>" SSH_PASSWORD = "<YOUR_SSH_PASSWORD>"
Gemini CLI에 SSH LICCO MCP 설치
$ gemini mcp add -s user -e 'SSH_HOST=<SSH_HOST>' -e 'SSH_USER=<SSH_USER>' -e 'SSH_PASSWORD=<YOUR_SSH_PASSWORD>' ssh-licco uvx -- ssh-liccoGemini settings.json에 SSH LICCO MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"ssh-licco": {
"command": "uvx",
"args": [
"ssh-licco"
],
"env": {
"SSH_HOST": "<SSH_HOST>",
"SSH_USER": "<SSH_USER>",
"SSH_PASSWORD": "<YOUR_SSH_PASSWORD>"
}
}
}
}구성
SSH_HOST필수SSH server hostname or IP address
SSH_USER필수SSH username for authentication
SSH_PASSWORD비밀SSH password for authentication
SSH_BASE_DIRSSH_CLIENT_TYPESSH_EXTRA_ALLOWED_COMMANDSSSH_KEEPALIVE_INTERVALSSH_PORTSSH port number
SSH_SECURITY_LEVELSSH_SESSION_TIMEOUTSSH_TIMEOUT
| 이름 | 설명 | 유형 |
|---|---|---|
| SSH_HOST | SSH server hostname or IP address | 필수 |
| SSH_USER | SSH username for authentication | 필수 |
| SSH_PASSWORD | SSH password for authentication | 비밀 |
| SSH_BASE_DIR | — | |
| SSH_CLIENT_TYPE | — | |
| SSH_EXTRA_ALLOWED_COMMANDS | — | |
| SSH_KEEPALIVE_INTERVAL | — | |
| SSH_PORT | SSH port number | |
| SSH_SECURITY_LEVEL | — | |
| SSH_SESSION_TIMEOUT | — | |
| SSH_TIMEOUT | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기🚀 SSH LICCO
让 AI 帮你操作服务器! 通过自然语言对话,AI 可以帮你执行命令、管理文件、查看日志、部署应用等。
📚 文档导航
快速开始
核心功能
高级主题
开发资源
- 🎓 Skills 文档 - 开发、运维、安装指南
- 📦 发布指南 - 一体化版本发布命令
- 🐛 GitHub Issues - 问题反馈
✨ 特性亮点
- 🎯 自然语言控制 - 用对话方式操作服务器
- 🔐 多种认证方式 - 密码、密钥、Agent 转发
- 🔗 长连接支持 - 自动保活(30 秒心跳),避免账户锁定
- ⏱️ 可配置超时 - Banner 超时 (60s)、会话超时 (2 小时),支持自动重连
- 📦 异步高性能 - 基于 Paramiko 的异步架构(线程池 + asyncio)
- 🛡️ 完善的异常处理 - 统一的错误处理机制(7 层异常层次)
- 📊 会话管理 - 支持多个并发 SSH 会话(最大 10 个,每主机 3 个)
- 📁 SFTP 文件传输 - 上传、下载、目录管理
- 🖊️ 远程文件编辑 - 直接写入/追加文件内容,无需下载再上传
- 🔑 密钥管理 - 生成和管理 SSH 密钥对(RSA/Ed25519)
- 📝 审计日志 - 完整的操作审计记录(JSON 结构化日志)
- 🚀 连接池 - 高性能连接复用(PooledConnection + ConnectionPool)
- 📊 批量执行 - 多主机并行命令执行(BatchExecutor + AsyncBatchExecutor)
- 🐳 Docker 支持 - Docker 构建和状态监控
- 📋 后台任务 - 可靠的后台进程启动(nohup + bash -c 包装,单次 SSH 调用无竞态)
- 🖥️ screen/tmux 会话 - 持久化远程会话,SSH 断开后进程依然存活
- 🪟 Windows 服务器支持 - 支持 Windows Server(OpenSSH for Windows)与 Linux/macOS 目标主机
- 🔍 进程管理 - 启动/停止/查询远程进程、SSH 端口转发(tunnel)
- 🔍 看门狗 - 任务监控、心跳检测、全局异常处理
- 🛡️ 文件传输路径安全校验 -
ssh_file_transferdelete 自动识别 Windows / Unix 路径风格并拦截敏感路径与路径遍历
🖥️ 目标主机支持
SSH-LICCO 基于标准 SSH/SFTP 协议,可连接以下目标主机:
| 操作系统 | 要求 | 备注 |
|---|---|---|
| Linux | OpenSSH 7.0+ | 推荐,完整支持所有功能 |
| Windows Server | OpenSSH for Windows / PowerShell Remoting over SSH | v2.1.3+ 支持 Windows 路径风格与安全校验 |
| macOS | 系统内置 OpenSSH | 完整支持 |
提示:连接 Windows 服务器时,请使用 Windows 风格路径(如
C:\temp\file.txt),系统会自动识别并进行路径安全校验。
📦 快速安装
方式一:pip 安装(推荐)
pip install ssh-licco
方式二:从源码安装
git clone https://github.com/Echoqili/ssh-licco.git
cd ssh-licco
pip install -e .
Python 版本要求: Python 3.10+
🚀 快速开始
1️⃣ 配置 MCP 服务器
在 Trae / Cursor / Claude Desktop 中使用
打开设置 → MCP → 添加新服务器:
{
"mcpServers": {
"ssh": {
"command": "python -m ssh_mcp.server"
}
}
}
2️⃣ 配置 SSH 连接(可选但推荐)
方式 A:环境变量配置(推荐)
{
"mcpServers": {
"ssh": {
"command": "python -m ssh_mcp.server",
"env": {
"SSH_HOST": "192.168.1.100",
"SSH_USER": "root",
"SSH_PASSWORD": "your_password",
"SSH_PORT": "22",
"SSH_TIMEOUT": "60",
"SSH_KEEPALIVE_INTERVAL": "30",
"SSH_SESSION_TIMEOUT": "7200",
"SSH_CLIENT_TYPE": "common"
}
}
}
}
环境变量说明:
SSH_HOST: SSH 服务器地址SSH_USER: 用户名SSH_PASSWORD: 密码SSH_PORT: 端口(默认 22)SSH_TIMEOUT: 连接超时(秒)SSH_KEEPALIVE_INTERVAL: 保活间隔(秒)SSH_SESSION_TIMEOUT: 会话超时(秒)SSH_CLIENT_TYPE: SSH 客户端类型(可选,默认common)common- paramiko(稳定可靠,推荐)⭐performance- asyncssh(高性能,适合高并发)🚀development- fabric(简化 API,适合快速开发)👨💻
🔐 安全配置
新增加固默认值与迁移说明见 安全边界与加固配置: 连接默认验证主机密钥,确认参数不再绕过命令策略,文件传输执行目录隔离。 下表是项目的模式说明,不是第三方平台的安全评分。
重要:从 v0.2.1 开始,ssh-licco 提供多级安全策略,可根据使用场景灵活配置。
多级安全策略
| 级别 | 名称 | 适用场景 | 防护强度 |
|---|---|---|---|
| STRICT | 严格模式 | 生产环境、公共服务器 | 最高 ⭐⭐⭐ |
| BALANCED | 平衡模式 | 开发环境、个人服务器(默认) | 高 ⭐⭐ |
| RELAXED | 宽松模式 | 测试环境、完全信任的服务器 | 中等 ⭐ |
快速配置
方式 1:环境变量(推荐)
Windows PowerShell:
$env:SSH_SECURITY_LEVEL = "balanced"
$env:SSH_EXTRA_ALLOWED_COMMANDS = "git,pip,npm"
Linux/Mac:
export SSH_SECURITY_LEVEL="balanced"
export SSH_EXTRA_ALLOWED_COMMANDS="git,pip,npm"
方式 2:MCP 配置文件
{
"mcpServers": {
"ssh": {
"command": "python -m ssh_mcp.server",
"env": {
"SSH_SECURITY_LEVEL": "balanced",
"SSH_EXTRA_ALLOWED_COMMANDS": "git,pip,npm",
"SSH_BASE_DIR": "/home"
}
}
}
}
📖 详细文档
- MCP_CONFIG_GUIDE.md - 完整配置指南,包含 5 种使用场景示例
- SECURITY_CONFIG_GUIDE.md - 安全配置详解
🛡️ 硬拦截灾难性命令(v2.2.0 新增)
为防止任何误操作或越权调用直接打到远程 shell,ssh-licco 在所有安全级别下都无条件拦截以下灾难性命令模式,无法通过 confirm_dangerous=true、confirmation_layer=N、调整 SSH_SECURITY_LEVEL 等任何方式绕过:
rm -rf作用于绝对路径(含/、/*、/path、/path/*,-fr变体同效)mkfs.*任意文件系统格式化dd if=/dev/(zero|random|urandom) of=/dev/(sd|nvme)覆写裸盘- bash fork-bomb(
:(){ :|:& };:及空白变体) chmod -R 777 //chmod -R 000 /根目录递归改权限> /dev/(sd|nvme)/>> /dev/(sd|nvme)裸设备重定向
如确需执行上述操作,请直接通过 SSH 登录服务器(绕过 MCP 网关)进行。安全且可逆的替代方案:
# 旧做法(v2.2.0 之前):rm -rf /path/to/junk ← 现已被硬拦截
# 推荐做法:mv 到回收站,约定时间后清理
mv /path/to/junk /tmp/.trash_$(date +%s)/
命中硬拦截时会输出 WARNING 审计日志(含 category 与命令),便于 SOC 监控。
🛠️ 可用工具(v2.2.0 维持 9 个;v2.1.0 曾增加的 3 个审批工具因流程闭环风险已下线)
| 工具 | 描述 | 核心能力 |
|---|---|---|
ssh_connect |
连接管理 | 自动读取环境变量/配置,支持密码+密钥认证,可保存配置,登录后自动执行命令 |
ssh_execute |
命令执行 | 自动连接、智能后台检测、长任务等待、超时控制,支持 nohup/screen/tmux 三种后台模式;v2.2.0 起对灾难性命令(rm -rf 绝对路径、mkfs、raw-disk dd、fork-bomb 等)做无条件硬拦截 |
ssh_disconnect |
会话管理 | 断开指定会话 OR 列出所有活跃会话 |
ssh_file_transfer |
文件传输 | 上传/下载/列表/写入/追加/删除/创建目录/查看元信息(8 种操作);v2.1.3+ delete 操作新增 Windows/Unix 敏感路径拦截与路径遍历防护 |
ssh_host |
主机管理 | action=list/add/remove 增删查主机配置 |
ssh_docker |
Docker 管理 | action=ps/images/build/logs 全生命周期管理 |
ssh_generate_key |
密钥生成 | RSA / Ed25519 密钥对 |
ssh_session |
screen/tmux 会话 | 持久化远程会话管理(create/send/capture/list/kill),SSH 断开后进程依然存活 |
ssh_process |
进程管理 | 启动/停止/查询远程进程,SSH 端口转发(tunnel_open/tunnel_close/tunnel_list) |
关于 v2.1.0 引入的 3 个审批工具(
ssh_request_approval/ssh_approve_command/ssh_list_approvals):已从 MCPlist_tools()移除,代码已在 v2.2.0 删除(ssh_mcp/approval.py、ssh_mcp/handlers/approval.py)。审批流程依赖 AI 自报命令、运维侧背书,存在闭环风险;v2.2.0 的硬拦截更直接——灾难性命令在 MCP 网关层就被拒绝,运维侧不需要再走"先申请再审批"流程。
📖 详细文档
- docs/API_REFERENCE.md - 完整 API 参考
- docs/skills/ssh-mcp-ops/SKILL.md - 运维操作指南
💡 使用示例
示例 1:执行命令
用户:帮我查看服务器上的 Docker 容器
AI:调用 ssh_connect → ssh_execute "docker ps"
[执行结果]
CONTAINER ID IMAGE COMMAND STATUS PORTS
abc123 nginx "nginx" Up 2 days 80:80
示例 2:文件上传
用户:把这个文件上传到 /var/www/html
AI:调用 ssh_connect → ssh_file_transfer
[上传成功]
本地:./index.html
远程:/var/www/html/index.html
大小:2.3 KB
示例 3:Docker 构建(长任务)
用户:帮我构建 Docker 镜像
AI:调用 ssh_execute(background=True) 后台执行 docker build...
[后台任务已启动]
Session ID: a1b2c3d4
命令:docker build -t myapp .
使用 ssh_execute(session_id="a1b2c3d4", command="cat /tmp/build.log") 查看进度
示例 4:数据库检查
用户:检查 PostgreSQL 是否正常运行
AI:调用 ssh_execute "pg_isready -h localhost -p 5432"
[检查结果]
localhost:5432 - accepting connections
✅ PostgreSQL 运行正常
📖 更多示例
- docs/skills/ssh-mcp-ops/SKILL.md - 运维操作示例
- docs/skills/ssh-mcp-dev/SKILL.md - 开发场景示例
📋 完整配置示例
场景 1:Web 开发者
{
"mcpServers": {
"ssh": {
"command": "python -m ssh_mcp.server",
"env": {
"SSH_SECURITY_LEVEL": "balanced",
"SSH_EXTRA_ALLOWED_COMMANDS": "git,npm,docker,composer,pm2",
"SSH_BASE_DIR": "/var/www",
"SSH_HOST": "192.168.1.100",
"SSH_USER": "deploy",
"SSH_PASSWORD": "your-password"
}
}
}
}
场景 2:Python 开发者
{
"mcpServers": {
"ssh": {
"command": "python -m ssh_mcp.server",
"env": {
"SSH_SECURITY_LEVEL": "balanced",
"SSH_EXTRA_ALLOWED_COMMANDS": "pip,poetry,python3,pytest,black",
"SSH_HOST": "192.168.1.100",
"SSH_USER": "developer",
"SSH_PASSWORD": "your-password"
}
}
}
}
场景 3:数据库管理员
{
"mcpServers": {
"ssh": {
"command": "python -m ssh_mcp.server",
"env": {
"SSH_SECURITY_LEVEL": "balanced",
"SSH_EXTRA_ALLOWED_COMMANDS": "psql,mysql,mongosh,pg_isready",
"SSH_HOST": "192.168.1.100",
"SSH_USER": "dbadmin",
"SSH_PASSWORD": "your-password"
}
}
}
}
场景 4:系统管理员
{
"mcpServers": {
"ssh": {
"command": "python -m ssh_mcp.server",
"env": {
"SSH_SECURITY_LEVEL": "relaxed",
"SSH_EXTRA_ALLOWED_COMMANDS": "sudo,apt,yum,systemctl,journalctl,docker,kubectl",
"SSH_HOST": "192.168.1.100",
"SSH_USER": "root",
"SSH_PASSWORD": "your-password"
}
}
}
}
场景 5:生产环境(最高安全)
{
"mcpServers": {
"ssh": {
"command": "python -m ssh_mcp.server",
"env": {
"SSH_SECURITY_LEVEL": "strict",
"SSH_HOST": "192.168.1.100",
"SSH_USER": "app-user",
"SSH_PASSWORD": "your-password",
"SSH_BASE_DIR": "/home/app-user"
}
}
}
}
📖 更多配置
- MCP_CONFIG_GUIDE.md - 包含所有配置选项的详细说明
🌐 完整环境变量速查(v2.3.0)
下表所有变量均被代码读取。注意:
SSH_RATE_LIMIT是 bool 总开关(true/false),SSH_RATE_LIMIT_MAX才是次数上限,两者分开配置- 主机密钥检查(strict_host_key_checking)不通过 env 配置,请用
ssh_connect工具参数或hosts.json
| 分类 | 变量 | 默认 | 说明 |
|---|---|---|---|
| 安全 | SSH_SECURITY_LEVEL |
balanced |
安全级别:strict / balanced / relaxed |
SSH_BASE_DIR |
/home |
Unix 远程 SFTP 路径校验基目录 | |
SSH_LOCAL_BASE_DIR |
当前工作目录 | 本地文件上传源与下载目标的允许目录 | |
SSH_EXTRA_ALLOWED_COMMANDS |
(空) | 额外允许的命令(逗号分隔) | |
SSH_ALLOWED_COMMANDS_FILE |
(空) | 命令白名单 JSON 文件路径 | |
SSH_AUDIT_LOG_PATH |
(空) | 审计日志文件路径 | |
| 限流 | SSH_RATE_LIMIT |
true |
限流总开关(bool) |
SSH_RATE_LIMIT_MAX |
30 |
限流次数上限 | |
SSH_RATE_LIMIT_WINDOW |
60 |
限流窗口(秒) | |
| 硬拦截 | (无 env) | — | 灾难性命令硬拦截,零配置零绕过 |
| 连接默认 | SSH_HOST / SSH_PORT / SSH_USER / SSH_PASSWORD |
127.0.0.1 / 22 / root / (空) |
单 host 模式默认连接参数 |
SSH_TIMEOUT |
60 |
连接超时(秒) | |
SSH_KEEPALIVE_INTERVAL |
30 |
keepalive 间隔(秒) | |
SSH_SESSION_TIMEOUT |
7200 |
会话超时(秒) | |
SSH_CLIENT_TYPE |
paramiko |
SSH 客户端实现:paramiko / asyncssh |
|
SSH_FORCE_ENV_CONFIG |
false |
强制 env 配置覆盖 hosts.json | |
SSH_SUDO_PASSWORD |
(空) | sudo 密码,配合 use_sudo=true 走 sudo -S |
⚠️ 依赖版本兼容性
已知依赖冲突
以下依赖版本冲突已在测试环境中验证,不影响 ssh-licco 的正常使用:
1. starlette 版本冲突
fastapi 需要 starlette<0.51.0
但安装了 starlette 0.52.1
影响范围:
- ✅ ssh-licco: 无影响,正常工作
- ⚠️ fastapi: 可能存在兼容性问题(如果同时使用 fastapi)
解决方案:
- 如果只使用 ssh-licco,可以忽略此警告
- 如果同时使用 fastapi,建议:
pip install starlette==0.50.0
2. cryptography 版本冲突
pyopenssl 需要 cryptography<45
但安装了 cryptography 46.0.5
影响范围:
- ✅ ssh-licco: 无影响,正常工作
- ⚠️ pyopenssl: 可能存在兼容性问题(如果同时使用 pyopenssl)
解决方案:
- 如果只使用 ssh-licco,可以忽略此警告
- 如果同时使用 pyopenssl,建议:
pip install cryptography==44.0.0
测试环境
测试通过的配置:
- ✅ starlette 0.52.1 + ssh-licco 0.4.1
- ✅ cryptography 46.0.5 + ssh-licco 0.4.1
- ✅ mcp 1.26.0 + ssh-licco 0.4.1
测试场景:
- ✅ SSH 连接和执行命令
- ✅ 文件上传和下载
- ✅ 后台任务执行
- ✅ Docker 构建和监控
- ✅ 多语言后台命令自动检测
为什么允许这些冲突?
ssh-licco 的核心依赖是:
mcp- MCP 协议实现asyncssh- SSH 客户端paramiko- SSH 客户端(稳定模式)pydantic- 数据验证
而 starlette 和 cryptography 是通过 mcp 间接引入的。ssh-licco 本身不直接使用这些库的 API,因此版本冲突不会影响 ssh-licco 的功能。
🔧 故障排查
常见问题
1. 连接失败
错误: Connection refused
解决:
- 检查 SSH 服务是否运行:
systemctl status sshd - 检查防火墙设置:
ufw status - 确认端口正确:默认 22
2. 认证失败
错误: Authentication failed
解决:
- 检查用户名和密码
- 尝试使用密钥认证
- 查看 SSH 日志:
/var/log/auth.log
3. 命令被阻止
错误: 命令 'xxx' 不在允许列表中
解决:
{
"SSH_SECURITY_LEVEL": "balanced",
"SSH_EXTRA_ALLOWED_COMMANDS": "被阻止的命令"
}
📖 详细文档
- docs/API_REFERENCE.md - API 参考和错误处理
- docs/skills/ssh-mcp-troubleshoot/SKILL.md - 故障排除指南
- MCP_CONFIG_GUIDE.md - 配置故障排查
🎓 学习资源
Skills 文档
配置文档
- MCP_CONFIG_GUIDE.md - 完整配置指南
- SECURITY_CONFIG_GUIDE.md - 安全配置详解
API 文档
- docs/API_REFERENCE.md - API 参考文档
🔗 相关链接
项目资源
- GitHub: https://github.com/Echoqili/ssh-licco
- PyPI: https://pypi.org/project/ssh-licco/
- MCP Registry: https://registry.modelcontextprotocol.io/servers/io.github.Echoqili/ssh-licco
- Issues: https://github.com/Echoqili/ssh-licco/issues
文档索引
| 文档 | 描述 | 位置 |
|---|---|---|
| 📖 配置指南 | 完整配置选项和场景 | MCP_CONFIG_GUIDE.md |
| 🔐 安全指南 | 安全配置详解 | SECURITY_CONFIG_GUIDE.md |
| 📊 API 参考 | 完整 API 文档 | docs/API_REFERENCE.md |
| 🎓 Skills | 开发、运维、安装指南 | docs/skills/ |
| 📦 发布指南 | 版本发布流程 | docs/skills/RELEASE_SKILL.md |
🧪 测试
测试状态
| 指标 | 状态 |
|---|---|
| 测试用例 | 311 passed, 0 skipped |
| 覆盖率 | 16 个源模块全覆盖 |
| 测试框架 | pytest + pytest-asyncio |
测试模块覆盖
| 源模块 | 测试文件 | 用例数 |
|---|---|---|
exceptions.py |
test_exceptions.py |
7 |
connection_config.py |
test_connection_config.py |
8 |
security.py |
test_security.py |
24 |
logging_config.py |
test_logging_config.py |
8 |
audit_logger.py |
test_audit_logger.py |
12 |
executor.py |
test_executor.py |
8 |
watchdog.py |
test_watchdog.py |
18 |
key_manager.py |
test_key_manager.py |
6 |
config_manager.py |
test_config_manager.py |
10 |
clients/interface.py |
test_factory.py |
10 |
clients/paramiko_client.py |
test_paramiko_client.py |
18 |
clients/factory.py |
test_factory.py |
10 |
session_manager.py |
test_session_manager.py |
18 |
connection_pool.py |
test_connection_pool.py |
10 |
batch_executor.py |
test_batch_executor.py |
10 |
server.py |
test_server.py |
30+ |
service.py |
test_service.py |
14 |
运行测试
# 运行全部测试
pytest tests/ -v
# 运行特定模块测试
pytest tests/test_security.py -v
# 查看覆盖率
pytest --cov=ssh_mcp --cov-report=term-missing
📦 发布流程
先在独立分支同步版本并运行测试:
python sync_version.py 2.8.1 --no-commit --no-tag
python sync_version.py --check
python -m pytest tests -q
node --test tests/install.test.cjs
代码合并后推送 vX.Y.Z 标签,现有发布流程依次执行版本校验、测试、打包、
PyPI 上传、公开安装源码核验,再创建或补齐 GitHub Release。
不需要向 npm 注册表发布;Node 安装包通过 GitHub Release 下载。
支持手动只验证,以及针对原标签恢复中断的发布。网络查询失败时停止上传; 已有 PyPI 文件和 Release 安装包不会重复覆盖。 详细操作及凭据配置见 发布与失败恢复。
📊 版本历史
SSH LICCO MCP 질문
SSH LICCO MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'SSH_HOST=<SSH_HOST>' --env 'SSH_USER=<SSH_USER>' --env 'SSH_PASSWORD=<YOUR_SSH_PASSWORD>' ssh-licco -- uvx ssh-licco를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
SSH LICCO MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
실수로 파괴적인 명령을 실행하는 것을 어떻게 방지하나요?
이 서버에는 절대 경로에 대한 'rm -rf' 실행, 디스크 포맷팅, fork bomb과 같은 치명적인 명령을 무조건적으로 차단하는 하드 인터셉트 기능이 포함되어 있으며, 이는 우회할 수 없습니다.
이 서버를 통해 Docker 컨테이너를 관리할 수 있나요?
네, 컨테이너 및 이미지 목록 확인, 빌드, 로그 확인 등 Docker의 전체 라이프사이클 관리를 위한 도구를 제공합니다.
지속적인 원격 세션을 지원하나요?
네, screen/tmux 세션 관리를 지원하므로 SSH 연결이 끊어진 후에도 프로세스가 계속 유지됩니다.