Remote Shell MCP

🔗 RemoteShell MCP

A. 模型上下文协议（MCP） 使LLM能够安全地管理和执行远程SSH服务器上的命令的服务器。

✨ 特性

• 🔐 安全的凭证管理 -保存SSH服务器配置文件一次，无需重新键入凭据
• 💻 远程命令执行 -远程执行非交互式shell命令
• 📁 文件 操作 -通过SFTP上传/下载文件
• 🤖 LLM供电 -内置于 FastMCP 帕拉米科

🚀 安装

适用于Claude Code用户

claude mcp add remoteshell --scope user -- uvx remoteshell-mcp

对于其他MCP客户端

将此添加到MCP客户端配置中：

{
  "mcpServers": {
    "remoteshell": {
      "command": "uvx",
      "args": ["remoteshell-mcp"]
    }
  }
}

📖 用法

开始很容易！您可以：

1. 🤖 让LLM为您配置 -只需告诉LLM您的主机、用户名、密码等，并要求它设置服务器配置
2. ⚙️ 手动配置 -直接在以下位置编辑配置文件 ~/.config/remoteshell/hosts.json

💾 配置和存储

RemoteShell将您的服务器配置安全地存储在：

~/.config/remoteshell/hosts.json

🔧 配置管理

• LLM管理：LLM使用以下命令自动管理此文件 save_server 和 remove_server 工具
• 手动编辑：您还可以直接编辑JSON文件以进行高级配置

📋 配置示例

{
  "version": 1,
  "servers": {
    "production-server": {
      "host": "1.2.3.4",
      "user": "root",
      "port": 22,
      "auth_type": "password",
      "password": "your_secure_password",
      "last_connected": null
    },
    "staging-server": {
      "host": "staging.example.com",
      "user": "ubuntu",
      "port": 22,
      "auth_type": "private_key",
      "private_key": "~/.ssh/id_rsa",
      "last_connected": "2025-01-01T00:00:00+00:00"
    }
  }
}

🔒 安全说明

在POSIX系统上，保护您的配置文件：

chmod 600 ~/.config/remoteshell/hosts.json

🛠️ 可用工具

RemoteShell为远程服务器管理提供了以下MCP工具：

📋 list_servers()

目的：显示所有已保存的服务器配置文件及其连接状态和上次活动。

何时使用:

• 用户要求“连接到服务器”或“显示机器”
• 无特定 connection_id 被提供
• 需要查看可用服务器

示例: *“显示我配置了哪些服务器”* → 返回所有已保存且处于联机状态的服务器的列表

💾 save_server(connection_id, host, user, auth_type, credential)

目的：使用身份验证凭据创建或更新服务器配置文件。

参数:

• connection_id：服务器的唯一标识符（例如，“生产”、“暂存”）
• host：服务器主机名或IP地址
• user：SSH用户名
• auth_type: "password" 或 "private_key"
• credential:

- 对于 password：纯文本密码字符串 - 对于 private_key：文件路径（例如。， ~/.ssh/id_rsa)或PEM密钥内容

何时使用:

• 添加新的服务器配置
• 身份验证失败后更新凭据
• 更改服务器连接详细信息

🗑️ remove_server(connection_id)

目的：从存储中永久删除服务器配置文件。

何时使用:

• 用户明确请求删除或忘记服务器
• 服务器不再可访问或不需要

⚠️ 警告：此操作无法撤消

⚡ execute_command(connection_id, command)

目的：远程执行非交互式shell命令并返回结果。

退货: stdout, stderr，以及 exit_code

何时使用:

• 运行系统命令、脚本或实用程序
• 检查服务器状态、磁盘使用情况、进程列表
• 文件操作、包管理等。

何时不使用:

• 交互式程序（vim、htop、top）
• 需要手动输入的命令([Y/n] 提示）-除非使用以下标志 -y

示例: execute_command(connection_id="production", command="df -h")

📤 upload_file(connection_id, local_path, remote_path)

目的：通过SFTP将文件从本地计算机上传到远程服务器。

参数:

• local_path：本地计算机上文件的路径
• remote_path：远程服务器上的目标路径

备注:

• 如果 remote_path 是一个目录，保留原始文件名
• 如果 local_path 如果省略，服务器将选择默认值并返回作为响应

📥 download_file(connection_id, remote_path, local_path)

目的：通过SFTP将文件从远程服务器下载到本地计算机。

参数:

• remote_path：远程服务器上文件的路径
• local_path：本地计算机上的目标路径

备注:

• 如果 local_path 省略，默认为： ~/.config/remoteshell/downloads//

🧪 发展

地方发展设置

对于本地开发，请使用此MCP配置：

{
  "mcpServers": {
    "remoteshell": {
      "command": "uv",
      "args": ["--directory", "/absolute/path/to/remoteShell-mcp", "run", "remoteshell-mcp"]
    }
  }
}

运行测试

uv run pytest