mcp-ssh-server

# SSH MCP Server 一个基于 Model Context Protocol (MCP) 的 SSH 服务器，提供通过 SSH 连接到远程服务器并执行命令的功能。 ## 功能特性 - 🔐 支持密码和SSH密钥认证 - 🌐 **支持多个命名SSH连接** - 🚀 执行远程shell命令 - 📊 获取命令执行结果（成功/失败状态、退出码） - 📝 获取命令输出内容（stdout、stderr） - 🔄 支持交互式命令执行 - 📤 支持文件上传（SFTP） - ⚡ 基于环境变量的灵活配置 - 🛡️ 完善的错误处理和日志记录 - ♻️ 向后兼容传统单连接配置 ## 快速开始 ### 方式一：使用 uvx（推荐，无需克隆） 直接在 MCP 客户端配置中使用 `uvx`，无需手动安装： #### Claude Desktop 编辑配置文件（Windows: `%APPDATA%\Claude\claude_desktop_config.json`，macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`）： ```json { "mcpServers": { "ssh": { "command": "uvx", "args": ["mcp-ssh-server"], "env": { "SSH_PROD_HOST": "your-server.com", "SSH_PROD_USERNAME": "admin", "SSH_PROD_PASSWORD": "your-password" } } } } ``` #### VS Code / Cursor 在项目根目录创建 `.mcp.json` 文件： ```json { "mcpServers": { "ssh": { "command": "uvx", "args": ["mcp-ssh-server"], "env": { "SSH_PROD_HOST": "your-server.com", "SSH_PROD_USERNAME": "admin", "SSH_PROD_PASSWORD": "your-password" } } } } ``` ### 方式二：从源码安装 ```bash # 克隆仓库 git clone https://github.com/liang04/ssh-mcp.git cd ssh-mcp # 使用 uv 安装 pip install uv uv sync # 或使用 pip 安装 pip install -e . ``` 配置 MCP 客户端使用本地安装： ```json { "mcpServers": { "ssh": { "command": "uv", "args": ["--directory", "/path/to/ssh-mcp", "run", "mcp-ssh-server"], "env": { "SSH_PROD_HOST": "your-server.com", "SSH_PROD_USERNAME": "admin", "SSH_PROD_PASSWORD": "your-password" } } } } ``` > **提示**：将 SSH 连接信息替换为您的实际配置。支持通过环境变量配置多个连接，详见下方配置说明。 ## 配置 ### 多连接配置（推荐） 通过环境变量配置多个命名SSH连接，格式为 `SSH_{连接名}_{参数名}`： ```bash # 生产环境连接 SSH_PROD_HOST=prod.example.com SSH_PROD_USERNAME=admin SSH_PROD_PASSWORD=prod_password SSH_PROD_PORT=22 # 测试环境连接 SSH_TEST_HOST=test.example.com SSH_TEST_USERNAME=tester SSH_TEST_KEY_PATH=/path/to/test_key SSH_TEST_PORT=2222 # 开发环境连接 SSH_DEV_HOST=dev.example.com SSH_DEV_U…