ssh-connector
Enables direct SSH management of Debian servers, including running commands, executing on groups, interactive shell sessions, SFTP file operations, port forwarding, background jobs, and journalctl-based event watching.
Enables direct SSH management of Red Hat servers, including running commands, executing on groups, interactive shell sessions, SFTP file operations, port forwarding, background jobs, and journalctl-based event watching.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
π 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.
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 ( |
π Safe sudo |
|
π 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 |
|
Related MCP server: mcp-ssh-tool
π¦ Install
Pick the way that fits you.
Claude Code β plugin (recommended)
claude plugin marketplace add ykinfohome7/ssh-connector
claude plugin install ssh-connector@ykinfohome7-toolsInside 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-connectorThen 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, headerAuthorization: Bearer <TOKEN>.
After an update press Refresh on the connector to load new commands. With Tailscale Funnel the address stays the same.
Download
β¬οΈ Latest version (ZIP)
π·οΈ Releases
git clone https://github.com/ykinfohome7/ssh-connector
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
Create
~/.ssh-connector/servers.yamlfromservers.example.yaml(or setSSH_CONNECTOR_CONFIG). Needspython3.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 |
| You get a one-time HTTPS link (2 min). Type the password there; it is checked on the server |
| Uses a preset value from an environment variable / GitHub Secret. Only its name is stored |
| 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 bashInstalls 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
stopincontrol/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 | ||
Security standards | ||
GitHub Actions session | ||
Changelog | ||
Contributing |
β€οΈ Like it? Want something?
β Like it β give the project a Star.
π‘ Want a feature β open a feature request.
π Found a bug β report it.
π License
GPL-3.0 Β© ykinfohome7
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Connect ChatGPT and Claude to your Mac, Windows or Linux with secure MCP remote access.
Scoped, audited SSH exec, sessions, and SFTP on your saved servers without exposing credentials
SSH client, server management and one remote MCP URL for your machines, with human approvals.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables remote server control via SSH through Claude, supporting command execution, file transfers, and multi-server management with both standard and streamable HTTP protocols.-
- AlicenseAqualityAmaintenanceSSH 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.331,267 npm4MIT
- -licenseNot gradedqualityNot gradedmaintenanceEnables Claude Code to control remote servers via SSH for automated deployment, testing, and operations, including command execution and file transfer.4-
- AlicenseAqualityDmaintenanceEnables natural language SSH server management via Claude Code, allowing users to read logs, check services, run commands, and transfer files across multiple servers.6MIT