Remote SSH Terminal MCP - AI-Powered Linux Server Management

by TiM00R

5 stars

408 downloads

Not rated

GitHub

About

AI-Powered Remote Linux Server Management via MCP - Let Claude execute commands on your servers

Details

Author: TiM00R
GitHub stars: 5
Downloads: 408
Categories: Developer Tools, Infrastructure

- Remote command execution on Linux servers
- Multi‑server management with easy switching
- File transfer (SFTP) with compression support
- Batch script execution (10‑50x faster)
- Saved batch script library and recipe system
- Full audit trail with SQLite database
- Interactive web terminal with real‑time output
- Multi‑terminal synchronization via WebSocket broadcast

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Remote SSH Terminal MCP - AI-Powered Linux Server Management

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

From the repository

Install the package via pip install remote-terminal-mcp in a Python virtual environment, then configure Claude Desktop by adding the server command to claude_desktop_config.json. On first run, configuration files (config.yaml, hosts.yaml) are auto‑created. Edit the hosts file to add your servers, restart Claude Desktop, and start giving commands like "Install nginx" or "Check disk space".

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "remote ssh terminal mcp - ai-powered linux server management": {
            "remote-terminal": {
                "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
                "env": {
                    "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
                }
            }
        }
    }
}

McpServers

{
    "remote-terminal": {
        "command": "C:\\RemoteTerminal\\venv\\Scripts\\remote-terminal-mcp.exe",
        "env": {
            "REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
        }
    }
}

Remote Terminal

AI-Powered Remote Linux Server Management via MCP

Remote Terminal lets Claude (the AI assistant) execute commands on your remote Linux servers through a natural chat interface. Watch full output in your browser in real-time while Claude receives smart-filtered summaries optimized for token efficiency.

---

🎯 What Is This?

Imagine telling Claude:

"Install nginx on my server and configure it with SSL"
"Run complete system diagnostics and tell me if anything looks wrong"
"Find all log errors from the last hour and summarize them"
"Save this batch script and run it again next week"

And Claude does it - executing commands, analyzing output, saving useful scripts, and taking action on your behalf.

That's Remote Terminal.

---

✨ Key Features

Core Capabilities

- 🖥️ Remote Command Execution - Run any bash command on Linux servers
- 🌐 Multi-Server Management - Switch between multiple servers easily
- 📁 File Transfer (SFTP) - Upload/download files and directories with compression
- 📜 Batch Script Execution - Run multi-command scripts 10-50x faster
- 📚 Batch Script Library - Save, browse, and reuse batch scripts (NEW in 3.1)
- 💬 Conversation Tracking - Group commands by goal with rollback support
- 🎯 Recipe System - Save successful workflows for reuse
- 🗄️ Database Integration - Full audit trail with SQLite
- 🌍 Interactive Web Terminal - Full-featured terminal in browser (type, paste, scroll history)
- 🔄 Multi-Terminal Sync - Open multiple terminals, all perfectly synchronized
- ✨ Bash Syntax Highlighting - VS Code-style colors in standalone UI (NEW in 3.1)

The Interactive Web Terminal

Remote Terminal provides a fully interactive terminal window in your browser at http://localhost:8080 - it looks and feels just like WSL, PuTTY, or any standard terminal:

You can:
- Type commands directly (just like any terminal)
- Copy/paste text (Ctrl+C, Ctrl+V)
- Scroll through command history
- Use arrow keys for history navigation
- View real-time command output with colors preserved

Claude can:
- Execute commands that appear in your terminal
- See command results instantly
- Continue working while you watch

The key advantage: You maintain complete visibility and control. Every command Claude runs appears in your terminal window in real-time. You're never in the dark about what's happening on your server - it's like sitting side-by-side with an assistant who types commands for you while you watch the screen.

Multi-Terminal Support: Open multiple browser windows at http://localhost:8080 - they all stay perfectly synchronized via WebSocket broadcast. Type in one terminal, see it in all terminals instantly. Perfect for multi-monitor setups or sharing your view with others.

⚠️ Best Practice: Close unused terminal tabs when done. While the system handles multiple connections efficiently, keeping many old tabs open can consume unnecessary resources and may cause connection issues.

🎬 See It In Action

<video width="800" controls>
<source src="https://raw.githubusercontent.com/TiM00R/remote-terminal/master/docs/demo.mp4" type="video/mp4">
Your browser does not support the video tag.
</video>

https://github.com/user-attachments/assets/98a6fa41-ec4f-410b-8d4a-a2422d8ac7c9

Watch the interactive web terminal in action - see Claude execute commands while you maintain full visibility and control

The Dual-Stream Architecture

Behind the scenes, Remote Terminal uses a smart two-stream approach:

           SSH Output from Remote Server
                      ↓
                  [Raw Output]
                      ↓
                 ┌────┴────┐
                 │         │
                 ↓         ↓
             [FULL]    [FILTERED]
                 │         │
                 ↓         ↓
            Web Terminal    Claude
         (You see all)  (Smart summary)

Result:
- You: Full visibility and control in interactive terminal
- Claude: Efficient work with 95% token savings
- Both: Shared SSH session, synchronized state
- Best of both worlds!

🚀 Quick Start

Installation

Step 1: Create Installation Directory
```powershell

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Remote Terminal

🎯 What Is This?

✨ Key Features

Core Capabilities

The Interactive Web Terminal

🎬 See It In Action

The Dual-Stream Architecture

🚀 Quick Start

Installation

Install

More like this

Sentry

Github

Git

GitLab

Context 7

Playwright