SSH MCP 服务器

SSH MCP 服务器 是一个本地模型上下文协议（MCP）服务器，它提供了对Linux和Windows系统的SSH控制功能，使LLMs和其他MCP客户端能够通过SSH安全地执行shell命令。

---

功能

• 符合MCP标准的服务器，提供SSH功能
• 在远程Linux和Windows系统上执行shell命令
• 通过密码或SSH密钥进行安全认证
• 内置安全检查的只读模式
• 使用TypeScript和官方MCP SDK构建

可用工具

工具	描述
get_available_connections	列出可通过SSH连接的机器
create_connection	打开一个新的SSH会话，并通过connection_id跟踪它
get_connections	列出所有活动的SSH会话
execute_command	运行shell命令（无限制）
secure_execute_command	更安全的命令执行；阻止破坏性操作
close_connection	关闭活动的SSH会话

---

快速开始

1. 克隆仓库

$ git clone https://github.com/vilasone455/ssh-mcp-server.git

2. 创建机器配置

创建一个具有以下结构的 machines.json 文件：

[
   {
    "machine_id": "todo-server-01",
    "label": "待办事项服务器",
    "os": "ubuntu",
    "source": "digitalocean",
    "ssh": {
      "host": "192.168.1.11",
      "port": 22,
      "username": "user",
      "password": "your_password_here"
    }
  },
  {
    "machine_id": "build-agent-01",
    "label": "CI 构建代理（密钥认证）",
    "os": "ubuntu",
    "source": "aws",
    "ssh": {
      "host": "192.168.1.12",
      "port": 22,
      "username": "ubuntu",
      "keyPath": "/home/ubuntu/.ssh/id_rsa"
    }
  }

]

---

客户端设置（Claude Desktop 示例）

要将此MCP服务器集成到Claude Desktop中，请添加服务器命令和所需的环境变量：

{
  "mcpServers": {
    "ssh-mcp": {
      "command": "node",
      "args": [
        "/path/to/ssh-mcp-server/dist/index.js"
      ],
      "env": {
        "MACHINES_PATH": "/path/to/your/machines.json"
      }
    }
  }
}

现在你可以使用自然语言与你的服务器交互，例如：“在待办事项VM上运行uptime。”

---

免责声明

自行承担风险。此服务器通过MCP提供shell级别的访问权限。请仔细审查命令并在安全环境中运行。

---

贡献

给仓库点赞、打开问题并提交拉取请求！欢迎反馈。