This project provides an MCP (Model Context Protocol) server enabling AI assistants like Claude Code and OpenAI Codex to manage remote SSH servers. It offers a comprehensive suite of 37 tools for DevOps automation, file management, database operations, and system monitoring, targeting engineers and power users seeking to integrate AI-driven automation into their infrastructure management workflows.

How It Works

The MCP SSH Manager acts as a bridge, translating AI assistant commands into executable SSH operations. It exposes a robust API with 37 distinct tools, covering everything from basic command execution and file transfers to complex database backups and system health monitoring. The core design leverages Node.js and the node-ssh library, integrating seamlessly with AI models through the MCP standard. This approach allows for natural language interaction with remote servers, abstracting away the complexities of SSH configuration and command-line interfaces.

Quick Start & Requirements

• Primary install: npm install -g mcp-ssh-manager (global) or npx mcp-ssh-manager. For AI integration, follow specific setup guides for Claude Code (claude mcp add ...) or OpenAI Codex (ssh-manager codex setup).
• Prerequisites: Node.js (v18+), npm, Bash 4.0+ (for CLI management tools), rsync. sshpass is optional for password-based rsync.
• Links:
  • npm: https://www.npmjs.com/package/mcp-ssh-manager
  • Releases: https://github.com/bvisible/mcp-ssh-manager/releases
  • Docs: Available within the repository (docs/, examples/).

Highlighted Details

• Extensive Toolset: Offers 37 tools for core SSH operations, backup/restore, health monitoring, database management, and deployment.
• Advanced Security Modes: Per-server configuration for unrestricted, readonly, or restricted modes to control AI actions and prevent unintended mutations. Includes an opt-in audit log.
• Cross-Platform Support: Works on Linux, macOS, and Windows (with OpenSSH).
• AI Context Optimization: Reduces AI context usage by up to 92% in minimal mode, enabling more efficient interaction with models like Claude Code.
• Network Flexibility: Supports ProxyJump/Bastion hosts and custom ProxyCommand configurations for complex network topologies.
• Authentication: Handles password, SSH key, and SSH Agent authentication, including passphrase-protected keys.

Maintenance & Community

The project shows active development with frequent releases, including significant updates in May and June 2026 (e.g., v3.6.2). Several contributors are acknowledged in release notes. Community interaction primarily occurs through GitHub Issues.

Licensing & Compatibility

Licensed under the MIT License, permitting broad use, modification, and distribution, including for commercial purposes.

Limitations & Caveats

Command timeouts are advisory; commands may continue on the server post-timeout, with specific handling required for Windows hosts. SSH sync via rsync with password authentication necessitates the sshpass utility. Large file transfers might appear unresponsive during processing. Stale SSH connections are automatically re-established.