classfang/ssh-mcp-server

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

987 stars 117 forks 품질 83 트렌드 41ISC

Repository Install

基于 SSH 的 MCP 서비스 🧙 ♀️ . 已被MCP官方收录 🎉 . SSH MCP 서버 🧙 ♀️ . 커뮤니티 MCP 저장소🎉에 포함되어 있습니다.

개요

SSH 기반 MCP(모델 컨텍스트 프로토콜) 서버로, MCP 프로토콜을 통해 SSH 명령어를 원격 실행할 수 있습니다. ssh-mcp-server는 AI 어시스턴트 및 MCP 프로토콜을 지원하는 다른 애플리케이션이 표준화된 인터페이스를 통해 원격 SSH 명령을 실행할 수 있도록 돕는 브리징 도구입니다. 이를 통해 AI 어시스턴트는 SSH 자격 증명을 AI 모델에 직접 노출하지 않고도 원격 서버를 안전하게 운영하고 명령을 실행하며 결과를 가져올 수 있습니다. 위챗으로 코드를 스캔하고 "그룹 가입"이라고 답장하세요. - : 비밀번호 인증과 개인 키 인증(패스프레이즈 지원 포함) 등 여러 보안 SSH 연결 방식을 지원합니다 - : 위험한 작업을 방지하기 위해 유연한 블랙리스트 및 화이트리스트 메커니즘을 통해 허용된 명령 범위를 정밀히 제어함 - : 프로토콜을 지원하는 AI 어시스턴트와의 원활한 통합을 위한 MCP 프로토콜 사양을 준수함 - : 직접 SSH 호스트 및 bastion 또는 점프 호스트 시나리오를 위한 실행 및 셸 전송 모드를 모두 지원합니다 -...

개요(AI 번역)

基于 SSH 的 MCP (Model Context Protocol) 서버,允许通过 MCP 协议远程执行 SSH 명령.

영어 문서 | 中文文档

📝 项目介绍

ssh-mcp-server라는 桥接工具,可以让 AI 助手等支持 MCP 协议的应用通过标准化接口执行远程 SSH 명령. 这使得 AI 助手能够安全地操作远程服务器,执行命令并获取结果,而无需直接暴露 SSH 凭据给 AI 模型。

💬 如有任何问题，欢迎加入微信群交流：

✨ 功能亮点

🔒 安全连接：支持多种安全的 SSH 连接方式，包括密码认证和私钥认证（支持带密码的私钥）
🛡️ 命令安全控制：通过灵活的黑白名单机制，精确控制允许执行的命令范围，防止危险操作
** 🔄 표준화 接口**:符合 MCP 协议规范,与支持该协议的 AI 助手无缝集成
** 🚇 双传输模式**:同时支持 exec 和 shell 两种 transport,兼容直连主机与堡垒机或跳板机场景
** 🌐 HTTP 접입**:默认使用 stdio;추가, --mcp-transport http 后通过 Streamable HTTP 提供 MCP 端点
📂 文件传输：支持双向文件传输功能，可上传本地文件到服务器或从服务器下载文件
** 🔑 凭据隔离**:SSH 凭据完全在本地管理,不会暴露给 AI 模型,增强安全性
** 🚀 即用即走**:使用 NPX 可直接运行,无需全局安装,方便快捷

📦 开源仓库

GitHub:https://github.com/classfang/ssh-mcp-server

NPM: https://www.npmjs.com/package/@fangjunjie/ssh-mcp-server

🛠️ 工具列表

工具	名称	描述
실행-명령	命令执行工具	在远程服务器上执行 SSH 명령并获取执行结果
업로드	文件上传工具	将本地文件或整个目录上传到远程服务器指定位置
다운로드	文件下载工具	从远程服务器下载文件或整个目录到本地指定位置
읽기 파일	读文件工具	通过 SFTP 读取远程文本文件,可按字节偏移分页,拒绝二进制文件
쓰기 파일	写文件工具	通过 SFTP 직접 写入文本内容(覆盖或추가 포함),不经过 shell 引号转义
리스트-서버	服务器列表工具	列出所有可用SSH服务器配置

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

📝 项目介绍

ssh-mcp-server 是一个桥接工具，可以让 AI 助手等支持 MCP 协议的应用通过标准化接口执行远程 SSH 命令。这使得 AI 助手能够安全地操作远程服务器，执行命令并获取结果，而无需直接暴露 SSH 凭据给 AI 模型。

💬 如有任何问题，欢迎加入微信群交流：

✨ 功能亮点

🔒 安全连接：支持多种安全的 SSH 连接方式，包括密码认证和私钥认证（支持带密码的私钥）
🛡️ 命令安全控制：通过灵活的黑白名单机制，精确控制允许执行的命令范围，防止危险操作
🔄 标准化接口：符合 MCP 协议规范，与支持该协议的 AI 助手无缝集成
🚇 双传输模式：同时支持 exec 和 shell 两种 transport，兼容直连主机与堡垒机或跳板机场景
🌐 HTTP 接入：默认使用 stdio；加上 --mcp-transport http 后通过 Streamable HTTP 提供 MCP 端点
📂 文件传输：支持双向文件传输功能，可上传本地文件到服务器或从服务器下载文件
🔑 凭据隔离：SSH 凭据完全在本地管理，不会暴露给 AI 模型，增强安全性
🚀 即用即走：使用 NPX 可直接运行，无需全局安装，方便快捷

📦 开源仓库

GitHub：https://github.com/classfang/ssh-mcp-server

NPM: https://www.npmjs.com/package/@fangjunjie/ssh-mcp-server

🛠️ 工具列表

工具	名称	描述
execute-command	命令执行工具	在远程服务器上执行 SSH 命令并获取执行结果
upload	文件上传工具	将本地文件或整个目录上传到远程服务器指定位置
download	文件下载工具	从远程服务器下载文件或整个目录到本地指定位置
read-file	读文件工具	通过 SFTP 读取远程文本文件，可按字节偏移分页，拒绝二进制文件
write-file	写文件工具	通过 SFTP 直接写入文本内容（覆盖或追加），不经过 shell 引号转义
list-servers	服务器列表工具	列出所有可用SSH服务器配置
job-start / job-status / job-kill / job-list	后台任务工具	启动超过命令超时限制的长任务，轮询输出与退出码，终止任务

📚 使用方法

0. 🤖 通过 AI Skill 快速配置（推荐）

如果你使用支持 skill 的 AI 编程助手（如 Claude Code），可以直接使用内置的 ssh-mcp-helper skill 通过交互式问答完成安装和配置，无需手动编辑 JSON 文件。

使用方式：

从本仓库 skills/ 目录安装该 skill
告诉你的 AI 助手：“帮我配置 ssh-mcp-server” 或 “给 Cursor 加一个 SSH MCP 连接”
skill 会逐步引导你：检查 Node.js 环境 → 选择 MCP 客户端 → 选择认证方式 → 收集连接参数 → 生成并写入配置

该 skill 支持下文所有场景（账号密码、私钥、SSH config 复用、SOCKS 代理、堡垒机、多连接、2FA、命令限制等），并自动生成格式正确的配置。

下面的章节按从简单到复杂的顺序排列，最简单的入门方式就是用账号密码连接服务器。直接复制对应场景下的 mcp.json 配置到你的 MCP 客户端即可使用。

⚠️ 重要提示：在 MCP 配置文件中，每个命令行参数和其值必须是 args 数组中的独立元素。不要用空格将它们连接在一起。例如，使用 "--host", "192.168.1.1" 而不是 "--host 192.168.1.1"。

1. 🔑 账号密码（最简单）

{
  "mcpServers": {
    "ssh-mcp-server": {

GitHub에서 전체 README 보기

설치

npx -y @fangjunjie/ssh-mcp-server --host 192.168.1.1 --port 22 --username root --password pwd123456

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "ssh-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host", "192.168.1.1",
        "--port", "22",
        "--username", "root",
        "--password", "pwd123456"
      ]
    }
  }
}