Mcp Ssh Wingman

@conallob

About Mcp Ssh Wingman

MCP Server for providing read only access to your shell prompt

#mcp-ssh-wingman #tmux #read-only-access

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ssh-wingman": {
      "command": "/usr/local/bin/mcp-ssh-wingman",
      "args": [
        "--session",
        "mcp-wingman"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.

Does MCP SSH Wingman support GNU screen

Frequently asked questions

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.

Comments

Basic information

More Developer Tools MCP servers

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K