SSH 远程 MCP 服务器

通过模型上下文协议 (MCP) 为兼容 MCP 的客户端提供 SSH 远程访问。

快速开始

1. 安装：

   pip install -r requirements.txt

2. 在 Claude Desktop 或 Claude Code 中添加 MCP：

   使用您的 MCP 配置并将命令设置为：

   python3 adremote-mcp/ssh_mcp_server.py

   或

   python.exe adremote-mcp/ssh_mcp_server.py

3. 在 Codex 中添加 MCP：

   将相同的服务器添加到您的 Codex MCP 配置中：

   python3 adremote-mcp/ssh_mcp_server.py

4. 自动设置：

   下载此仓库，运行 Claude 或 Codex，并要求它将此文件夹添加为全局 MCP 服务器。 之后，您可以直接在聊天中使用它。

功能

• 适用于 Windows 和 Linux 上兼容 MCP 的客户端

• 通过 SSH 连接到远程服务器

• 原生 SSH 跳板机 / 堡垒机支持

• 远程执行命令

• 通过 SFTP 上传/下载文件

• 管理多个连接

• 健康监控

使用示例

使用密码连接：

Connect to 192.168.1.100 with username ubuntu and password mypass

或使用简写形式：

ssh 192.168.1.100:22 ubuntu mypass

MCP 首先会使用您的用户名和密码测试 SSH 连接。 如果登录成功，它会生成或安装 SSH 密钥，在本地保存基于密钥的凭据，并且不会保存密码。 密码仅在第一次使用。

使用密码进行一次性会话连接：

ssh 192.168.1.100:22 ubuntu mypass, save_credentials false

这仅保持实时连接。不会保存可重用的凭据，也不会尝试自动引导密钥。

稍后使用保存的名称连接：

ssh saved-name

首次成功设置后，只需使用保存的凭据名称即可再次连接。

通过跳板机连接：

在 ssh_connect 或 ssh_save_credentials 上使用 jump_host 对象：

{
  "hostname": "10.0.2.15",
  "username": "ubuntu",
  "private_key_path": "~/.ssh/id_ed25519",
  "jump_host": {
    "hostname": "203.0.113.10",
    "username": "bastion",
    "private_key_path": "~/.ssh/id_ed25519",
    "port": 22
  }
}

这会使用原生 SSH 隧道连接到目标主机，并且保存的凭据会保留相同的跳板机配置。 对于可重用的保存凭据，跳板机必须使用 private_key_path 而不是密码。

执行命令：

List files in /home directory on my server
Run 'top' command on the remote server
Execute script.py and monitor its log

文件传输：

Upload local file.txt to /home/user/ on the server
Download /var/log/app.log from the server

连接健康状况和清单：

Check health of all SSH connections
Show me all active SSH connections

要求

• Python 3.10+

• paramiko

• mcp

最新更新

版本 1.0.1 增加了更安全、更实用的日常 SSH 工作流程：

• 直接登录默认仍会保存可重用凭据，但 save_credentials=false 现在也可以明确选择不保存密码会话

• 保存的凭据流程现在包括连接、保存、列出、删除和手动密钥设置助手

• 主机信任和文件传输规则更加严格，具有本地根目录限制和首次使用信任的主机锁定

• 原生跳板机连接支持实时会话和保存的凭据

• 保存的凭据基于密钥，因此正常使用时无需主密码

• 手动保存的私钥路径会在保存时进行验证，而不是在首次连接时才验证

支持

联系我进行协作。