Mcp Ssh Wingman
@conallob
MCP Server for providing read only access to your shell prompt
Overview
What is MCP SSH Wingman?
A Model Context Protocol (MCP) server that provides read-only access to Unix shell prompts via tmux. It enables AI assistants like Claude to safely observe terminal environments without executing commands.
How to use MCP SSH Wingman?
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.
Key features of MCP SSH Wingman
- 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
Use cases of MCP SSH Wingman
- Monitor long-running processes and build outputs
- Observe terminal-based application behavior
- Debug issues by reviewing terminal history
- Provide context-aware assistance based on current terminal state
FAQ from MCP SSH Wingman
How does MCP SSH Wingman differ from other SSH MCP servers?
It enforces read-only access via tmux, never sending keystrokes or commands, eliminating the risk of accidental execution.
What are the runtime dependencies?
tmux must be installed. Optionally Go 1.21+ is needed only for building from source.
Where does the terminal data reside?
Data is read from local tmux sessions; there is no remote access.
