ssh-mcp-server

ssh-mcp-server

site icon
2025.04.17 1
JavaScript远程命令执行SSH 桥接开发效率
ssh-mcp-server 是一个基于 SSH 的 MCP (Model Context Protocol) 服务器,它允许通过 MCP 协议远程执行 SSH 命令。作为一个桥接工具,它使得支持 MCP 协议的应用(如 AI 助手)能够通过标准化接口安全地操作远程服务器,执行命令并获取结果,而无需直接暴露 SSH 凭据给 AI 模型。
View on GitHub

Overview

基本能力

产品定位

ssh-mcp-server 是一个桥接工具,用于通过 MCP 协议远程执行 SSH 命令,特别适用于 AI 助手等应用安全地操作远程服务器。

核心功能

  • 通过 MCP 协议远程执行 SSH 命令
  • 支持密码、私钥和带密码私钥等多种认证方式
  • 提供标准化的接口,避免直接暴露 SSH 凭据

适用场景

  • AI 助手远程操作服务器
  • 自动化脚本执行远程命令
  • 安全地管理远程服务器

工具列表

  • npx @fangjunjie/ssh-mcp-server: 用于启动 ssh-mcp-server 并配置相关参数

常见问题解答

使用教程

使用依赖

  • Node.js 环境
  • npm 或 yarn 包管理器

安装教程

  1. 确保已安装 Node.js 和 npm/yarn
  2. 使用以下命令安装 ssh-mcp-server:
npx -y @fangjunjie/ssh-mcp-server

调试方式

  1. 配置 MCP 服务器参数,如主机地址、端口、用户名、密码或私钥等
  2. 启动服务后,通过日志或返回结果验证命令执行情况

MCP 配置示例

使用密码

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

使用私钥

{
  "mcpServers": {
    "ssh-mpc-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host 192.168.1.1",
        "--port 22",
        "--username root",
        "--privateKey ~/.ssh/id_rsa"
      ]
    }
  }
}

使用带密码私钥

{
  "mcpServers": {
    "ssh-mpc-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host 192.168.1.1",
        "--port 22",
        "--username root",
        "--privateKey ~/.ssh/id_rsa",
        "--passphrase pwd123456"
      ]
    }
  }
}

许可证

该项目遵循 ISC 开源许可条款,请参阅 ISC 了解完整条款。