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.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
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
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
MCP Ssh Wingman 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 MCP Server for providing read only access to your shell prompt