MCP SSH 工具服务器

一个基于MCP框架的SSH工具服务器，提供远程服务器管理功能。

功能特性

• 支持多服务器配置管理
• 提供SSH连接池管理
• 支持文件上传/下载（包括递归目录操作）
• 支持远程命令执行
• 可通过环境变量或代码配置服务器

安装

1. 使用uv安装Python 3.13+:

uv pip install --python=3.13

2. 安装项目依赖:

uv pip install "mcp[cli]"
uv pip install  requests  paramiko

3. (可选) 使用uv创建虚拟环境:

uv venv .venv
source .venv/bin/activate  # Linux/Mac
.venv\Scripts\activate     # Windows

4. 下载代码:

git clone https://github.com/nwnusun-cool/mcp-server-ssh-tools.git

配置

使用json文件配置服务器，示例：

{
  "mcpServers": {
    "ssh_sun": {
      "command": "uv",
      "args": [
        "--directory",
        "F:\\仓库\\产品\\mcp-server-ssh-tools",
        "run",
        "main.py"
      ],
      "env": {
        "SSH_IP": "192.168.2.127",
        "SSH_USER": "root",
        "SSH_PASSWORD": "123456",
        "SSH_PORT": "22"
      }
    }
  }
}

使用

API接口

• execute: 执行远程命令
• download_file: 下载远程文件/目录
• upload_file: 上传本地文件/目录
• list_directory: 列出远程目录内容
• test_connection: 测试服务器连接

依赖

• mcp[cli]>=1.10.1
• paramiko>=3.5.1
• pyyaml>=6.0.2
• requests>=2.32.4

开发

# 安装开发依赖
pip install -e ".[dev]"

# 运行测试
pytest

许可证

MIT