Mcp Ssh Wingman
About
MCP Server for providing read only access to your shell prompt
Details
- Author
- conallob
- Downloads
- 282
- Categories
- Developer Tools
Jump to
- Read-only terminal access with no execution risk
- Integrates with tmux session management
- Captures scrollback history
- Retrieves terminal metadata (dimensions, path, session info)
- Uses standard MCP protocol for AI assistant integration
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
Mcp Ssh WingmanCommand (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
Install via Homebrew or pre-built binaries, then launch with mcp-ssh-wingman (optionally with --session my-session). Integrate with Claude Desktop or Gemini CLI by adding the server to their configuration files and restarting the client.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp ssh wingman": {
"ssh-wingman": {
"command": "/usr/local/bin/mcp-ssh-wingman",
"args": [
"--session",
"mcp-wingman"
]
}
}
}
}McpServers
{
"ssh-wingman": {
"command": "/usr/local/bin/mcp-ssh-wingman",
"args": [
"--session",
"mcp-wingman"
]
}
}MCP SSH Wingman
A Model Context Protocol (MCP) server that provides read-only access to Unix shell prompts via tmux. This enables AI assistants like Claude to safely observe terminal environments without executing commands.
Features
- 🔒 Read-only access - Observe terminal content without execution risks
- 🖥️ tmux integration - Leverages tmux's session management for reliable terminal access
- 📜 Scrollback history - Access historical terminal output
- 📊 Terminal metadata - Retrieve dimensions, current path, and session info
- 🔌 MCP protocol - Standard protocol for AI assistant integration
FAQ
Will you be adding GNU screen support?
Not in the immediate future. Although screen can be used for pair programming/debugging, it does not have any mechanism to enforce read only mode.
Since the read-only safeguard is the main difference between this MCP and other MCPs with ssh functionality , screen will need to support read-only sessions before it can be integrated
Will you be adding zellij support?
In the future, possibly. https://github.com/zellij-org/zellij/issues/4348 needs to be implemented first, to ensure zellij has read-only functionality, just like tmux
Prerequisites
- tmux (for terminal session management)
- (Optional) Go 1.21 or later (only needed for building from source)
Installation
Homebrew (macOS/Linux)
brew tap conallob/tap
brew install mcp-ssh-wingman
Pre-built binaries
Download pre-built binaries from the releases page.
Available for:
- macOS (arm64/amd64)
- Linux (arm64/amd64)
- FreeBSD (arm64/amd64)
Build from source
See DEVELOPMENT.md for build instructions.
Usage
Running the server
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
