快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

uv run ssh-mcp-server

详细介绍

SSH MCP服务器（Python）

SSH提供连接功能MCP（Model Context Protocol）服务器Python实施。FastMCP使用库uv中所述修改相应参数的值。

📁 项目结构

ssh_mcp_server_python/
├── pyproject.toml          # プロジェクト設定とビルド設定
├── uv.lock                 # 依存関係ロックファイル
├── src/                    # ソースコード
│   └── ssh_mcp_server_python/
│       ├── __init__.py     # パッケージ初期化
│       └── main.py         # メインサーバー実装
├── .env                    # 環境設定（要作成）
├── .env.example            # 環境設定テンプレート
├── start.bat               # Windows起動スクリプト
├── start.sh                # Linux/Mac起動スクリプト
├── test_tools_list.py      # ツールリストテスト
├── validate.py             # 設定検証スクリプト
└── README.md               # このファイル

机能

SSH接続管理：支持密码和私钥身份验证
执行远程命令：也可以指定工作目录
文件传输: SFTP通过上传下载
系统信息获取：获取有关连接的详细信息
自动设定検证：自动检查设置有效性
详细日志输出：便于调试的日志功能

前提条件

Python 3.10以上
uv（Python 包管理器）

uv安装：

# Windows (PowerShell)
irm https://astral.sh/uv/install.ps1 | iex

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

快速启动

1.设置依赖关系

uv sync

此命令执行以下操作：

自动创建虚拟环境
必需的Python安装软件包
生成锁定文件（uv.lock）

2. SSH设置连接信息

.env编辑文件SSH请设置连接信息：

# 基本設定
UBUNTU_SSH_HOST=192.168.1.100
UBUNTU_SSH_PORT=22
UBUNTU_SSH_USERNAME=your_username

# パスワード認証の場合
UBUNTU_SSH_PASSWORD=your_password

# または秘密鍵認証の場合
UBUNTU_SSH_PRIVATE_KEY_PATH=/path/to/your/private/key
UBUNTU_SSH_PRIVATE_KEY_PASSPHRASE=your_passphrase_if_needed

3.启动服务器

# uvを使った実行（推奨）
uv run ssh-mcp-server

# または起動スクリプトを使用
# Windows
start.bat

# Linux/Mac
./start.sh

可用工具

｜工具名称｜说明｜主要参数｜ |---------|------|----------------| | connect_ssh | SSH接続を確立 | 主机、用户名、密码/private_key| | execute_命令 执行远程命令command, cwd（工作目录） | 上传文件 上传文件local_path, remote_path | | 下载文件 下载文件remote_path, local_path | | disconnect_ssh | SSH断开连接｜无｜ | get_system_info ｜获取系统信息｜无｜

工具详细信息

connect_ssh：未指定参数时使用环境变量（.env）的值
execute_命令：获取所有标准输出、标准错误和结束代码
上传文件/下载文件：带目录自动创建功能
get_system_info: uname、磁盘使用量、内存、进程信息等

手动设置（详细信息）

安装相关性

# uvを使用（推奨）
uv sync

# または従来のpip
pip install fastmcp paramiko python-dotenv

所需的软件包：

fastmcp -MCP（模型上下文协议）サーバーフレームワーク
paramiko - SSH/SFTP客户机
python-dotenv - 環境変数管理

在开发环境中运行

# 開発モードでの実行
uv run python src/ssh_mcp_server_python/main.py

# または仮想環境を有効化して実行
uv shell
python src/ssh_mcp_server_python/main.py

设定検证

可以检查配置是否正确：

uv run python validate.py

此命令检查：

.env文件存在
确认必填项
确认私钥文件的存在
Python软件包安装

测试运行

检查工具列表：

uv run python test_tools_list.py

VS代码/克劳德桌面での設定

VS Code MCP设定

VS Code单击功能区上Copilot进行动态观察时的轴心点mcp.json请在文件中添加以下设置：

文件位置:

窗户： %APPDATA%\Code\User\mcp.json
macOS： ~/Library/Application Support/Code/User/mcp.json
Linux： ~/.config/Code/User/mcp.json

{
  "servers": {
    "ssh-mcp-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/your/ssh_mcp_server_python",
        "ssh-mcp-server"
      ],
      "env": {
        "UBUNTU_SSH_HOST": "192.168.56.103",
        "UBUNTU_SSH_PORT": "22",
        "UBUNTU_SSH_USERNAME": "your_username",
        "UBUNTU_SSH_PASSWORD": "your_password"
      }
    }
  }
}

Claude Desktop设定

Claude Desktop使用时，在配置文件中添加以下内容：

文件位置:

窗户： %APPDATA%\Claude\claude_desktop_config.json
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ssh-server": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/your/ssh_mcp_server_python",
        "ssh-mcp-server"
      ],
      "env": {
        "UBUNTU_SSH_HOST": "192.168.56.103",
        "UBUNTU_SSH_PORT": "22",
        "UBUNTU_SSH_USERNAME": "your_username",
        "UBUNTU_SSH_PASSWORD": "your_password"
      }
    }
  }
}

设置要点

路径设置: --directory请根据您的环境更改路径
环境变数: SSH连接信息为.env在文件或配置文件中指定
安全性：密码不在配置文件中.env推荐文件

使用方法

这个服务器Model Context Protocol进行动态观察时的轴心点。MCP客户端（例如：Claude Desktop、VS Code），模板名称将采用不同的格式。

基本使用流程

connect_ssh 单击功能区上SSH建立连接
execute_command 执行远程命令
根据需要 upload_file / download_file 文件传输
get_system_info 获取系统信息
作业完了后、disconnect_ssh 断开连接

使用示例：Docker构建执行

1. connect_ssh() でSSH接続
2. execute_command("docker run --rm -v /home/user/project:/workspace -w /workspace ubuntu-dev bash -c './Build.sh'")
3. disconnect_ssh() で切断

示例：文件传输和脚本执行

1. connect_ssh() でSSH接続
2. upload_file("local_script.py", "/tmp/script.py")
3. execute_command("python3 /tmp/script.py", cwd="/tmp")
4. download_file("/tmp/output.txt", "result.txt")
5. disconnect_ssh() で切断

故障排除

常见问题

连接错误: .env检查文件设置
验证错误：确认密码或私钥设置
程序包错误: uv sync 执行
缺少命令: uv run ssh-mcp-server 确认路径

uv命令问题

# 間違い
uv python test_tools_list.py

# 正しい
uv run python test_tools_list.py

检查日志

服务器运行时将输出详细的日志。可以确认连接和命令执行的状况。

调试模式

单击功能区上的src/ssh_mcp_server_python/main.py中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积

logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')

安全注意事项

.env文件包含敏感信息，请勿包含在版本控制中
SSH连接仅在可信网络上使用
请注意私钥文件的权限设置（通常为600）
在生产环境中，建议使用环境变量管理凭据

技术仕样

程序设计语言：Python 3.10+
MCP框架结构：FastMCP 2.11.2
包管理器：紫外线
项目结构：src布局
SSH/SFTP程序库：paramiko
设定管理：python dotenv

开发人员信息

uvの特徴

高速：传统pip更快的软件包解析安装
再现可能: uv.lock可靠的依赖关系管理
简单的：集成虚拟环境和包管理

src-layout采用结构

标准的: Python业界广泛采用的结构
分离：明确分离源代码和项目文件
测试：正确隔离测试文件和源代码

许可证

MIT许可证

目录标签

PythonClaude系统监控SSH管理本地部署远程命令执行文件传输自动化工具

支持客户端

Claude DesktopClaudeVS Code

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

none

运行时（runtime，运行环境）

Python

工具数量（toolCount，工具数）

6

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdionone部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/1d2302b36cbadc83b7602944eb5d37cf

一个基于Python的SSH连接管理工具，提供远程命令执行、文件传输和系统信息获取功能，适用于自动化脚本和远程服务器管理。

继续浏览同类 MCP

更多运维云端 MCP（13,854）返回 MCP 目录

上一个 MCP

Ssh MCP Server E3655d56

SSH MCP服务器是一个集中式网络设备管理系统，通过SSH API执行命令，提供网络监控、配置验证和报告功能。

下一个 MCP

Ssh Server MCP

一个用于动态管理SSH服务器连接并执行命令的工具，支持密码和私钥认证、配置文件加载、远程命令执行及连接管理。

ssh MCP server python