Remote SSH Terminal MCP - AI-Powered Linux Server Management
About
AI-Powered Remote Linux Server Management via MCP - Let Claude execute commands on your servers
Details
- License
- MIT
Explore
- 🖥️ 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)
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 ManagementCommand (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
From the repository
Step 1: Create Installation Directory
mkdir C:\RemoteTerminal
cd C:\RemoteTerminal
Step 2: Install Package
python -m venv remote-terminal-env
remote-terminal-env\Scripts\activate
pip install remote-terminal-mcp
Step 3: Configure Claude Desktop
Edit %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"remote-terminal": {
"command": "C:\\RemoteTerminal\\remote-terminal-env\\Scripts\\remote-terminal-mcp.exe",
"env": {
"REMOTE_TERMINAL_ROOT": "C:\\RemoteTerminal"
}
}
}
}
Important: Replace C:\RemoteTerminal with your actual installation path from Step 1.
Step 4: First Run - Auto Setup
Restart Claude Desktop. On first use, configuration files will automatically copy to C:\RemoteTerminal:
- config.yaml - Default settings (auto-created from package defaults)
- hosts.yaml - Server list (auto-created from template)
Step 5: Configure Your Servers
You have two options to configure your servers:
Option A: Manual Configuration (Recommended for first server)
Edit C:\RemoteTerminal\hosts.yaml:
``yaml
servers:
- name: My Server
host: 192.168.1.100
user: username
password: your_password
port: 22
description: My development server
tags:
- development
Configuration files are automatically copied to your working directory on first run:
For PyPI users:
- Set REMOTE_TERMINAL_ROOT in Claude Desktop config%REMOTE_TERMINAL_ROOT%\config.yaml
- Files auto-copy to that directory on first run
- Location: and hosts.yaml
- User data preserved when reinstalling/upgrading
Default template files packaged with installation:
- config/config.yaml - Default settings templateconfig/hosts.yaml.example` - Server configuration template
-
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
