MCP SSH Server

MCP SSH Server

site icon
2024.12.03 19
TypeScript远程管理文件传输SSH服务其它
MCP SSH Server 是一个基于SSH协议的强大服务器实现,专为Model Context Protocol (MCP)设计。它支持通过SSH协议进行安全的远程命令执行和文件操作,提供密码和基于密钥的认证方式。
View on GitHub

Overview

基本能力

产品定位

MCP SSH Server 是一个安全、高效的SSH服务器实现,专注于提供远程命令执行和文件操作的能力,适用于需要远程管理和文件传输的场景。

核心功能

  • ✨ 安全的SSH连接管理
  • 🔑 密码和基于密钥的认证
  • 💻 远程命令执行
  • 📁 文件操作(上传/下载)
  • 📊 文件传输进度跟踪
  • 🔐 权限管理
  • 📂 目录操作
  • 🚀 批量文件传输
  • 📝 详细日志记录

适用场景

  • 远程服务器管理
  • 批量文件传输
  • 自动化脚本执行
  • 安全文件操作

工具列表

  • node: 用于运行服务器脚本
  • npm: 用于安装和管理依赖
  • git: 用于克隆和贡献代码

常见问题解答

  • 如何更改服务器端口? 通过设置环境变量SSH_PORT来更改端口。
  • 如何更改日志级别? 通过设置环境变量SSH_LOG_LEVEL来更改日志级别。

使用教程

使用依赖

  1. 确保已安装Node.js和npm。
  2. 确保已安装git(如果需要从源码安装)。

安装教程

  1. 安装包:
npm install mcp-ssh
  1. 添加到Claude桌面配置(claude_desktop_config.json):
{
  "mcpServers": {
    "ssh": {
      "command": "node",
      "args": ["%APPDATA%/npm/node_modules/mcp-ssh/dist/server.js"],
      "env": {
        "SSH_PORT": "8889",
        "SSH_LOG_LEVEL": "info"
      }
    }
  }
}

调试方式

  1. 启动服务器:
npm start
  1. 使用提供的PowerShell命令测试连接和操作。
  2. 检查日志以获取调试信息。

许可证

该项目遵循 MIT 开源许可条款。