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