Skip to main content
Glama

πŸ” SSH Connector

Work directly over SSH on many servers β€” from Claude and ChatGPT. Commands, interactive terminals, SFTP, tunnels, failover, events and a safe sudo password β€” no gateway in between.

Version Tests License: GPL-3.0 Stars

English Β· Π‘ΡŠΠ»Π³Π°Ρ€ΡΠΊΠΈ

Install Β· Quick start Β· Commands Β· Security Β· Changelog


✨ What it does

πŸ–₯️ Many servers

Debian and Red Hat, primary + fallback addresses, automatic failover, retries, keepalive

⌨️ Real terminal

Interactive shell with PTY that keeps state (cd, variables, running programs, Ctrl+C)

πŸ”‘ Safe sudo

sudo_password β€” type it on a one-time page, take it from the profile, or generate it with your length and characters. Never in the chat

πŸ“ Files

SFTP: list, read, write, upload, download, mkdir, remove, rename

πŸš‡ Tunnels

Local port forwarding, jump hosts (bastion)

πŸ‘€ Events

Watch errors, crashes / OOM and logins without asking

🧩 Groups & snippets

Run one command on a whole group; saved commands

🌐 Tailscale

Status, devices, auth keys β€” and a permanent HTTPS address via Funnel

🧰 GitHub Codespaces

List/status, wake and confirmation-protected stop via authenticated GitHub CLI; requires Codespaces permission

πŸ“– Help built in

help lists all 48 commands in BG and EN with a ready example

Related MCP server: mcp-ssh-tool

πŸ“¦ Install

Pick the way that fits you.

claude plugin marketplace add ykinfohome7/ssh-connector
claude plugin install ssh-connector@ykinfohome7-tools

Inside a session: /plugin marketplace add ykinfohome7/ssh-connector, then /plugin install ssh-connector@ykinfohome7-tools. The first start creates a private virtualenv (~30 s, only once).

ChatGPT Codex β€” plugin

codex plugin marketplace add ykinfohome7/ssh-connector

Then enable ssh-connector in the plugin list.

ChatGPT / Claude apps (web, phone) β€” connector over HTTPS

They need a public HTTPS address. Use the always-on server or the GitHub Actions session, then add the connector:

  • ChatGPT: Settings β†’ Apps & Connectors β†’ Advanced β†’ Developer mode β†’ Create β†’ URL https://<host>/<TOKEN>/mcp, no authentication.

  • Claude: Settings β†’ Connectors β†’ Add custom connector β†’ URL https://<host>/mcp, header Authorization: Bearer <TOKEN>.

After an update press Refresh on the connector to load new commands. With Tailscale Funnel the address stays the same.

Download

Manual MCP (no plugin)

git clone https://github.com/ykinfohome7/ssh-connector && cd ssh-connector
claude mcp add ssh -- sh $(pwd)/plugins/ssh-connector/bin/run.sh     # Claude Code
codex  mcp add ssh -- sh $(pwd)/plugins/ssh-connector/bin/run.sh     # Codex

πŸš€ Quick start

  1. Create ~/.ssh-connector/servers.yaml from servers.example.yaml (or set SSH_CONNECTOR_CONFIG). Needs python3.

  2. Ask in plain words, e.g. "show disk usage on all web servers" β€” or call commands directly:

{"tool": "server_test", "arguments": {"name": "web1"}}
{"tool": "run_command", "arguments": {"server": "web1", "command": "df -h"}}
{"tool": "help", "arguments": {}}

Full list with parameters and examples: docs/COMMANDS.md.

🧰 GitHub Codespaces (new in 1.3.3)

Three additional MCP tools: codespace_status(name="") lists available Codespaces or checks one; codespace_start(name) wakes an existing Codespace; codespace_stop(name, confirm=true) stops it only after explicit confirmation. They call the GitHub REST API through the authenticated gh CLI on the connector host, and need the GitHub codespace scope or the repository's Codespaces lifecycle admin permission. Tokens are not passed as tool arguments.

Important: a backend running inside a stopped Codespace cannot wake itself. To wake an offline Codespace, call these commands from an independently running connector host (or use GitHub directly).

πŸ”‘ sudo password (new in 1.3.3)

When a command needs sudo, the connector does not hang β€” it asks you to choose:

Mode

What happens

prompt

You get a one-time HTTPS link (2 min). Type the password there; it is checked on the server

profile

Uses a preset value from an environment variable / GitHub Secret. Only its name is stored

generate

Random password β€” you choose length (16–128) and characters. Shown once; set on the server only after you press "I saved it"

The password is never in the chat, in the command, in the logs or in the history. It reaches sudo over stdin.

🌍 Always-on server

Run once on one of your servers (e.g. from Termius):

curl -fsSL https://raw.githubusercontent.com/ykinfohome7/ssh-connector/main/install-server.sh | sudo bash

Installs a systemd service, an HTTPS tunnel, a token and an SSH key, and prints what to paste into Claude and ChatGPT. Show it again: sudo ssh-connector-info.

☁️ GitHub Actions session

An on-demand backend in GitHub Actions with a permanent address https://ssh-connector.<tailnet>.ts.net (Tailscale Funnel; fallback: Cloudflare quick tunnel).

  • Start / restart: edit control/session (start + anything new on line 2) or Actions β†’ connector-session β†’ Run workflow.

  • Stop: put stop in control/session.

  • Status and address: control/status.md.

Full setup (secrets, Tailscale, BGDB Codespaces): docs/GITHUB-SESSION.md.

πŸ›‘οΈ Security

  • Passwords, keys and tokens are never shown or stored in files β€” only environment-variable names and paths.

  • SSH keys: Ed25519, RSA 4096 only for old systems, rotation every 40–90 days (credentials_rotate).

  • Requests without the token get 401. Treat the token like an SSH key.

  • Found a vulnerability? See SECURITY.md.

πŸ“š Documentation

Document

English

Π‘ΡŠΠ»Π³Π°Ρ€ΡΠΊΠΈ

Commands

COMMANDS.md

COMMANDS.bg.md

Security standards

SECURITY-STANDARDS.md

SECURITY-STANDARDS.bg.md

GitHub Actions session

GITHUB-SESSION.md

GITHUB-SESSION.md

Changelog

CHANGELOG.md

CHANGELOG.md

Contributing

CONTRIBUTING.md

CONTRIBUTING.md

❀️ Like it? Want something?

πŸ“„ License

GPL-3.0 Β© ykinfohome7

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      SSH automation MCP server that enables Claude and ChatGPT to execute commands, manage files, install packages, and control services on remote servers over SSH β€” supporting password, key, and agent authentication.
      33
      1,267 npm
      4
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables Claude Code to control remote servers via SSH for automated deployment, testing, and operations, including command execution and file transfer.
      4
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables natural language SSH server management via Claude Code, allowing users to read logs, check services, run commands, and transfer files across multiple servers.
      6
      MIT