mcp -ssh

This MCP server provides a secure SSH-based interface for MCP-enabled clients to perform remote command execution and file operations. It supports both password and key-based authentication, enabling you to connect to remote hosts, run commands, upload/download files, and manage directories with progress tracking and logging. Clients can leverage the SSH endpoint to perform typical administrative tasks on MCP-enabled targets via the provided REST-like pathways exposed by the SSH server implementation. Use the connect endpoint to establish an SSH session, then use exec to run commands, upload to transfer files, download to retrieve files, and ls/status to inspect directories and connection state.

Prerequisites:

• Node.js and npm installed on the host
• Access to install npm packages

Installation steps:

1. Install the MCP SSH package globally or locally within your project: npm install mcp-ssh

2. Configure your environment or Claude desktop config to point to the installed server script. Example (for Claude): { "mcpServers": { "ssh": { "command": "node", "args": ["%APPDATA%/npm/node_modules/mcp-ssh/dist/server.js"], "env": { "SSH_PORT": "8889", "SSH_LOG_LEVEL": "info" } } } }

3. Start the server (if running locally): npm start

4. Verify the server is reachable on the configured port (default 8889) and test authentication as configured (password or key-based).

Notes and tips:

• The server exposes SSH-based MCP endpoints for connect, exec, upload, download, and directory operations. Ensure your firewall allows traffic on the configured SSH_PORT (default 8889).
• SSH_PORT and SSH_LOG_LEVEL can be tuned via environment variables to fit your environment and logging needs.
• If using key-based authentication, ensure your keys are accessible by the client and that passphrases (if any) are handled securely.
• When deploying, consider securing access with network-level restrictions and enabling appropriate logging levels in SSH_LOG_LEVEL for troubleshooting.
• The configuration snippet uses the typical Claude desktop integration path; adapt the path if your installation layout differs.