SSH LICCO MCP Server
io.github.Echoqili/ssh-licco·v2.7.3·4 starsSSH Model Context Protocol Server - Enable SSH functionality for AI models
4 stars165 downloads/wk
Reviews
Write oneNobody has reviewed SSH LICCO MCP Server yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
SSH LICCO MCP Server tools (9, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
ssh_connectEstablish an SSH connection to a remote server. If no parameters are provided, auto-connects using environment variables or saved config. Supports password, private key, and agent authentication. Optionally save the config and/or execute a command after connecting.
ssh_disconnectClose an active SSH session. If no session_id is provided, lists all currently active sessions with connection details.
ssh_dockerManage Docker on the remote server. Supports ps (list containers), images (list images), build (build an image in background), and logs (view container logs).
ssh_executewrite actionExecute a command on a remote server. If session_id is omitted, auto-connects using environment variables. Supports background execution for long-running tasks (auto-detected or manual). Use session_type='screen' or 'tmux' for persistent sessions that survive SSH disconnect.
ssh_file_transferwrite actionTransfer and manage files between local and remote server via SFTP. Supports upload, download, list, write (write content directly to remote file), append, delete, mkdir, stat, and remote_copy (server-to-server direct transfer via scp/rsync, avoiding local relay).
ssh_generate_keyGenerate a new SSH key pair (RSA or Ed25519) for secure key-based authentication. Optionally save to a file path.
ssh_hostManage SSH server configurations in hosts.json. Use action=list to view all hosts, action=add to register a new server, action=remove to delete a server.
ssh_processManage background processes and SSH tunnels on the remote server. Actions: start (launch a detached background process, returns PID), stop (stop a process by PID), status (check if a PID is running), list (list tracked background tasks), tunnel_open (local port forward to remote host:port), tunnel_close (close a tunnel), tunnel_list (list active tunnels).
ssh_sessionManage persistent screen/tmux sessions on the remote server for long-running interactive tasks (deploy, build, test, REPL). Sessions survive SSH disconnect. Actions: create (new detached session running a command), send (send keys/command to a session), capture (read current screen), list (list sessions), kill (kill a session).
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan35 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 8 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How SSH LICCO MCP Server compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 68% of 4,460 AI and agents servers
- Tools
- 9
- the typical AI and agents server has 6
- Tools that change things
- 22%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 4
- more than 77% of 2,711 AI and agents servers
- Downloads a week
- 165
- more than 72% of 1,538 AI and agents servers with a package
What its tools let an agent do: 7 read · 2 change
Release history: 2 versions in the registry since 2026-08-18, latest 2026-10-11, typically one every 54 days.
Install SSH LICCO MCP Server in Claude Code, Cursor or VS Code
claude mcp add ssh-licco -- uvx ssh-licco
What the publisher says
From the SSH LICCO MCP Server repository's README, as published. We do not edit it. Read it on GitHub
🚀 SSH LICCO
<!-- mcp-name: io.github.Echoqili/ssh-licco -->
让 AI 帮你操作服务器! 通过自然语言对话,AI 可以帮你执行命令、管理文件、查看日志、部署应用等。
📚 文档导航
快速开始
- ⬇️ 安装指南 - 2 种安装方式
- 🚀 快速开始 - 5 分钟上手
- 📋 配置模板 - 开箱即用的配置
核心功能
- 🔐 安全配置 - 多级安全策略
- 🛠️ 可用工具 - 完整功能列表
- 💡 使用示例 - 实际应用场景
高级主题
- 📖 完整配置指南 - 所有配置选项详解
- 🔧 故障排除 - 常见问题解决
- 📊 API 参考 - 详细 API 文档
开发资源
- 🎓 Skills 文档 - 开发、运维、安装指南
- 📦 发布指南 - 一体化版本发布命令
- 🐛 GitHub Issues - 问题反馈
✨ 特性亮点
- 🎯 自然语言控制 - 用对话方式操作服务器
- 🔐 多种认证方式 - 密码、密钥、Agent 转发
- 🔗 长连接支持 - 自动保活(30 秒心跳),避免账户锁定
- ⏱️ 可配置超时 - Banner 超时 (60s)、会话超时 (2 小时),支持自动重连
- 📦 异步高性能 - 基于 Paramiko 的异步架构(线程池 + asyncio)
- 🛡️ 完善的异常处理 - 统一的错误处理机制(7 层异常层次)
- 📊 会话管理 - 支持多个并发 SSH 会话(最大 10 个,每主机 3 个)
- 📁 SFTP 文件传输 - 上传、下载、目录管理
- 🖊️ 远程文件编辑 - 直接写入/追加文件内容,无需下载再上传
- 🔑 密钥管理 - 生成和管理 SSH 密钥对(RSA/Ed25519)
- 📝 审计日志 - 完整的操作审计记录(JSON 结构化日志)
- 🚀 连接池 - 高性能连接复用(PooledConnection + ConnectionPool)
🖥️ 目标主机支持
SSH-LICCO 基于标准 SSH/SFTP 协议,可连接以下目标主机:
提示:连接 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: 连接超时(秒)
- SSHKEEPALIVEINTERVAL: 保活间隔(秒)
- SSHSESSIONTIMEOUT: 会话超时(秒)
- SSHCLIENTTYPE: SSH 客户端类型(可选,默认 common)
- common - paramiko(稳定可靠,推荐)⭐
- performance - asyncssh(高性能,适合高并发)🚀
- development - fabric(简化 API,适合快速开发)👨💻
🔐 安全配置
重要:从 v0.2.1 开始,ssh-licco 提供多级安全策略,可根据使用场景灵活配置。
多级安全策略
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
SSH LICCO MCP Server: common questions
- Is SSH LICCO MCP Server safe?
- Mostly: it is graded B (83/100). Read the SSH LICCO MCP Server safety report
- How do I install SSH LICCO MCP Server?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does SSH LICCO MCP Server need an API key?
- Yes. The registry entry asks for
SSH_PASSWORD. - Is SSH LICCO MCP Server maintained?
- The last commit was 9 days ago (2026-10-26). The latest release is v2.7.3.
- How does SSH LICCO MCP Server compare with other AI and agents MCP servers?
- safety score 83/100 (higher than 68% of 4,460 AI and agents servers); tools 9 (the typical AI and agents server has 6); tools that change things 22% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.