MCP SSH Wingman
A Model Context Protocol (MCP) server that provides read-only access to Unix shell prompts via . This enables AI assistants like Claude to safely observe terminal environments without executing commands.
Potencialize seu agente
Instalação do publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
Ainda não há uma versão empacotada no registro. Siga o README do repositório.
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
tmuxscreen 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
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
brew tap conallob/tap
brew install mcp-ssh-wingman
Download pre-built binaries from the releases page.
Available for:
See DEVELOPMENT.md for build instructions.
# Start with default tmux session name (mcp-wingman)
mcp-ssh-wingman
# Use a custom tmux session name
mcp-ssh-wingman --session my-session
# Show version
mcp-ssh-wingman --version
Add the server to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"ssh-wingman": {
"command": "/usr/local/bin/mcp-ssh-wingman",
"args": ["--session", "mcp-wingman"]
}
}
}
Restart Claude Desktop after updating the configuration.
Add this section to your Gemini config file (~/.gemini/settings.json):
{
"mcpServers": {
"ssh-wingman": {
"command": "/usr/local/bin/mcp-ssh-wingman",
"args": ["--session", "mcp-wingman"]
}
}
}
Run the gemini CLI and make sure it can see the MCP server:
> /mcp list
Configured MCP servers:
🟢 ssh-wingman - Ready (3 tools)
Tools:
- get_terminal_info
- read_scrollback
- read_terminal
Test with a prompt:
> using ssh-wingman MCP Server, what do you see in my session?
╭────────────────────────────────────────────────────────────────────────────────────────╮
│ ? read_terminal (ssh-wingman MCP Server) {} ← │
│ │
│ MCP Server: ssh-wingman │
│ Tool: read_terminal │
│ │
│ Allow execution of MCP tool "read_terminal" from server "ssh-wingma… │
│ │
│ ● 1. Yes, allow once │
│ 2. Yes, always allow tool "read_terminal" from server "ssh-wingma… │
│ 3. Yes, always allow all tools from server "ssh-wingman" │
│ 4. No, suggest changes (esc) │
│ │
╰────────────────────────────────────────────────────────────────────────────────────────╯
⠏ Waiting for user confirmation...
You might as well select option 3 there.
The server exposes the following MCP tools:
read_terminalRead the current terminal content from the tmux session.
Example:
{
"name": "read_terminal"
}
read_scrollbackRead scrollback history from the tmux session.
Parameters:
lines (number): Number of lines to retrieve from scrollback bufferExample:
{
"name": "read_scrollback",
"arguments": {
"lines": 100
}
}
get_terminal_infoGet information about the terminal (dimensions, current path, etc.).
Example:
{
"name": "get_terminal_info"
}
terminal://currentCurrent terminal content as a text resource.
terminal://infoTerminal metadata and information.
The server creates or attaches to a tmux session and uses tmux's built-in commands to safely read terminal content:
tmux capture-pane to read visible contentThis approach ensures that the AI assistant can observe terminal activity without any risk of accidentally executing commands or modifying the terminal state.
MCP SSH Wingman is designed with security in mind:
tmux -Vchmod +x /usr/local/bin/mcp-ssh-wingmantmux list-sessionsContributions are welcome! Please feel free to submit issues or pull requests.
For development guidelines, see DEVELOPMENT.md.
MCP Server for providing read only access to your shell prompt
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
MCP Ssh Wingman roda localmente via stdio.
Última verificação: 2026-10-28. MCP Server for providing read only access to your shell prompt