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.
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน 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.
เปิดจากผู้เผยแพร่
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
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
MCP Ssh Wingman ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 MCP Server for providing read only access to your shell prompt