See it in action: Demo Video
The Problem
If you've ever used AI to help manage a Linux server, you know the drill:
- Forgot a command? Ask Claude
- Copy the command, switch to your terminal, paste it
- Get 500 lines of output
- Copy it all, paste back to Claude for analysis
- Claude burns tokens reading the whole thing just to say "nginx is running fine"
- Repeat for the next command
One command at a time. Copy. Paste. Copy. Paste. Token waste.
Some MCP servers try to solve this by letting Claude run commands directly. But they're completely blind - commands execute behind the scenes and you get back a text summary. No terminal. No visibility. No control. Would you let someone manage your production server while blindfolded?
The Solution: Remote Terminal MCP
I built Remote Terminal MCP - an SSH server management tool where you and Claude share the same terminal session.
The key: there's a full interactive terminal in your browser at localhost:8080. This isn't a log viewer - it's a real terminal like WSL, PuTTY, or Termius. Colored output, scroll history, copy/paste, arrow keys, and everything else you'd expect.
When Claude runs a command, you see it appear in your terminal in real-time. And you can type your own commands at any moment - intervene, correct course, run something manually.
How It Works
Behind the scenes, Remote Terminal uses a dual-stream architecture:
- Your terminal gets the full raw output - every line, every color
- Claude gets smart-filtered summaries saving 95-98% on tokens
- When Claude needs the full output, it can request the unfiltered version
Both streams share the same SSH session. You're never in the dark about what's happening on your server.
Features
- Interactive browser terminal - colored output, scroll, type, paste, arrow keys
- Shared session - both AI and user type in the same terminal
- Multi-terminal sync - open multiple browser windows, all stay synchronized
- Multi-server management - configure and switch between servers easily
- SFTP file transfers - upload/download files and directories with compression
- Batch script execution - run multi-command scripts 10-50x faster than one at a time
- Recipe system - save successful workflows and replay them on any server
- Command audit trail - every command persisted across sessions in SQLite
Install
It's a PyPI package, so getting started is simple:
pip install remote-terminal-mcp
Configure Claude Desktop to use it, define your servers in hosts.yaml, and you're ready to go. Full setup instructions on GitHub.
Links
- GitHub: https://github.com/TiM00R/remote-terminal
- PyPI: https://pypi.org/project/remote-terminal-mcp/
- MCP Registry: Published and active
Would love feedback and suggestions. What features would you want to see next?
Top comments (2)
Interesting. I will try
Awesome, good job