JinDaGe - ssh-mcp MCP Details

article

README

🚀 SSH MCP 服务器

SSH MCP 服务器 是一款本地模型上下文协议（MCP）服务器，它能够为 Linux 和 Windows 系统开放 SSH 控制功能。借助它，大型语言模型（LLM）以及其他 MCP 客户端可以通过 SSH 安全地执行 shell 命令，为用户提供便捷、安全的操作体验。

🚀 快速开始

安装 SSH MCP 服务器。
配置 SSH MCP 服务器。
设置您的 MCP 客户端（例如 Claude Desktop、Cursor 等）。
使用自然语言通过 SSH 在远程 Linux 或 Windows 服务器上执行 shell 命令。

✨ 主要特性

作为符合 MCP 协议的服务器，开放 SSH 功能。
可在远程服务器上执行 shell 命令。
支持通过密码或 SSH 密钥进行安全身份验证。
使用 TypeScript 和官方 MCP SDK 构建。

工具

exec：在远程服务器上执行 shell 命令。

📦 安装指南

克隆仓库：

git clone https://github.com/tufantunc/ssh-mcp.git
cd ssh-mcp

安装依赖项：

npm install

📚 详细文档

客户端设置

您可以配置 Claude Desktop 使用此 MCP 服务器。

host：Linux 或 Windows 服务器的主机名或 IP 地址。
port：SSH 端口（默认：22）。
user：SSH 用户名。
password：SSH 密码（或使用 key 进行密钥身份验证）（可选）。
key：私有 SSH 密钥的路径（可选）。

{
    "mcpServers": {
        "ssh-mcp": {
            "command": "npx",
            "args": [
                "ssh-mcp",
                "-y",
                "--",
                "--host=1.2.3.4",
                "--port=22",
                "--user=root",
                "--password=pass",
                "--key=path/to/key"
            ]
        }
    }
}

测试

您可以使用 MCP 检查器进行此 MCP 服务器的可视化调试。

npm run inspect

免责声明

SSH MCP 服务器按 MIT License 提供。自行承担风险使用。该项目与任何 SSH 或 MCP 提供商无关或得到其认可。

支持

如果您发现 SSH MCP 服务器对您有帮助，请考虑为仓库点赞或贡献！拉取请求和反馈非常受欢迎。

ssh-mcp