io.github.Areso/safe-ssh-mcp
PYPI · SAFE-SSH-MCP
A secured scoped SSH MCP server for executing safe read-only diagnostic DevOps / SysOps commands
Available components
Last scanned (11 hours ago)
Scores higher than 70% of PyPI servers
Category Cloud Infrastructure
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 1 of 21 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to Areso/safe-ssh-mcp). View diagnostics → Pass
- Clear OSI-approved license (AGPL-3.0-or-later).Pass
- Actively maintained (last published 4 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability50
- AI-judged instruction clarity (fair).Partial
- Context-footprint check failed: tool/resource definitions use about 8488 tokens (~151/item across 56 items; 56 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management23
- Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage71
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 56 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 56 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (16)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Nov 26 +16
- Malware scan: unverified → pass ▲ security
- 19 Nov 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.
- 17 Nov 26 −14
- Malware scan: pass → unverified ▼ security
- Stability: unverified → 0.07 ▲ functional
- Package version: 0.2.1 → 0.2.3 functional
- 16 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 15 Nov 26 +10
- Malware scan: pass → unverified ▼ security
- Injection markers: unverified → pass ▲ security
- First check of Judged manipulation: pass security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Tool coverage: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- First check of Tool coverage: 0 functional
- First check of Schema quality: fail functional
- First check of Schema quality: fair functional
- First check of Destructive annotations: pass functional
- First check of Schema quality: fail functional
- First check of Tool coverage: 100 functional
- Package version: 0.2.0 → 0.2.1 functional
- 13 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 12 Nov 26 0
- Malware scan: unverified → pass ▲ security
- Package version: 0.1.15 → 0.2.0 functional
- 11 Nov 26 −15
- Malware scan: pass → unverified ▼ security
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 22 Nov 2026 · Analysed pypi/safe-ssh-mcp@0.2.3
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | pypi |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | Areso/safe-ssh-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/Areso/safe-ssh-mcp/.github/workflows/publish.yml@refs/tags/v0.2.3 |
| Rekor log index | 3952430926 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:0dbbc28267b97e7ad51844264302183a71fbc59f9bd894456979b4561798faf6 |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | Known build tool | setuptools.build_meta |
Background: Why install scripts are a supply-chain risk →
Dependencies 21 packages
| Packages resolved | 21 |
|---|---|
| Stale | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
check_tcp_connect ~271
Checks FROM a remote Linux host (reached via SSH) whether a TCP connection to target_host:target_port can be opened (nc -vz). USE THIS TOOL to tell whether a service (database, API, another server) is reachable from that host. target_host is a hostname or an IPv4/IPv6 address, target_port is 1-65535. Do not confuse them with host/port, which are the SSH connection to the machine the check runs on. Only the connection is opened and closed, no data is sent. One port per call. ok=True means the port accepted the connection. Otherwise nc's message tells why: 'Connection refused' - the target is reachable but nothing listens on the port; 'timed out' - no answer in 3 seconds, usually a firewall or a routing problem; a name resolution error - check the name with get_dns_lookup. Fails with exit code 127 if nc is not installed on the host.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| target_host | string | yes | – |
| target_port | integer | yes | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_coredumps ~241
Inspects crashes (core dumps) recorded by systemd-coredump on a remote Linux host via SSH. command='list' lists the last `lines` core dumps (time, PID, signal, executable), below the column header. When there are no core dumps, coredumpctl exits with code 1 and ok is False - that is not a failure. command='info' shows details of a core dump (signal, command line, stack trace if available): of the given pid, or of the most recent one when pid is omitted. Optional since limits them to a time window: '30 min ago', '2 hours ago', 'today', 'yesterday' or 'YYYY-MM-DD HH:MM:SS'. Seeing other users' core dumps usually requires root.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| command | string | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| lines | integer | – | – |
| password | – | – | – |
| pid | – | – | – |
| port | integer | – | – |
| since | – | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_crictl_imagefsinfo ~118
Collects crictl imagefsinfo output (mountpoint, used bytes and inodes of the CRI image filesystem of a kubernetes node) from a remote Linux host via SSH. USE THIS TOOL to investigate image garbage collection and DiskPressure. Usually requires root.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_crictl_images ~104
Collects crictl images output (image, tag, image ID, size of images present in the CRI runtime of a kubernetes node) from a remote Linux host via SSH. Usually requires root.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_crictl_inspect ~156
Inspects a SPECIFIC CRI container (crictl inspect, JSON) on a kubernetes node from a remote Linux host via SSH: state, exit code and reason, timestamps, image, mounts, log path, pid and the runtime spec. Use get_crictl_ps first to find the container ID. Usually requires root. Values of environment variables are replaced by '<redacted>'; their names are kept.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| container_id | string | yes | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_crictl_inspect_image ~170
Inspects a SPECIFIC image (crictl inspecti, JSON) in the CRI runtime of a kubernetes node from a remote Linux host via SSH: repo tags and digests, size, user, entrypoint/cmd, layers. image is an image name ('registry.k8s.io/pause:3.9') or an image ID from get_crictl_images. Usually requires root. Values of environment variables are replaced by '<redacted>'; their names are kept.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| image | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_crictl_logs ~186
Gets the last `lines` log lines (stdout and stderr merged) of a SPECIFIC CRI container on a kubernetes node from a remote Linux host via SSH. Works when the API server is down. Use get_crictl_ps first to find the container ID. Usually requires root. Optional since limits them to a time window: '30 min ago', '2 hours ago', '30m', '1h30m' or an absolute UTC time 'YYYY-MM-DDTHH:MM:SSZ'.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| container_id | string | yes | – |
| host | string | yes | – |
| key_path | – | – | – |
| lines | integer | – | – |
| password | – | – | – |
| port | integer | – | – |
| since | – | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_crictl_ps ~110
Collects crictl ps --all output (all CRI containers on a kubernetes node, including exited ones: container ID, image, state, name, attempt, pod) from a remote Linux host via SSH. Usually requires root.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_crontab_tasks ~82
Collects crontab -l (crontab list) output from a remote Linux host via SSH
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_current_datetime ~70
Collects current datetime from a remote Linux host via SSH
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_disk_free ~75
Collects disk usage (df -h) from a remote Linux host via SSH.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_disk_usage ~97
Collects disk usage for a specific abs path from a remote Linux host via SSH. Returns the top 20 largest files/folders in the specified directory.
| Name | Type | Req | Description |
|---|---|---|---|
| abs_path | string | – | – |
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_distroname_version ~76
Collects distr details from os-release from a remote Linux host via SSH
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_dmesg ~183
Collects dmesg log from a remote Linux host via SSH. Reading the kernel log usually requires root: when the login user is not root, the command is run through passwordless sudo or doas (sudo -n / doas -n). Optional since limits it to recent messages: '30 min ago', '2 hours ago', 'today', 'yesterday' or 'YYYY-MM-DD HH:MM:SS'. It requires util-linux 2.37+ on the remote host; on older hosts dmesg fails with an unrecognized option error - then call without since.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| since | – | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_dns_lookup ~335
Resolves a hostname (or reverse-resolves an IP address) ON a remote Linux host via SSH, and prints its /etc/resolv.conf. USE THIS TOOL to check what a name resolves to from that host. By default uses getent, which resolves exactly like applications on the host do (/etc/hosts, nsswitch.conf, then DNS). A name that does not resolve gives exit code 2. use_dig=True queries the DNS servers directly with dig (bypassing /etc/hosts) and returns the full answer: status (NOERROR, NXDOMAIN, SERVFAIL), CNAME chain, TTLs, the server that answered and query time. It fails with exit code 127 if dig is not installed - then use use_dig=False. The next two parameters require use_dig=True: record_type is one of A (default), AAAA, CNAME, MX, NS, TXT, SOA, PTR, SRV, CAA. server (IP address or hostname, e.g. '8.8.8.8') asks that DNS server instead of the ones in /etc/resolv.conf - compare both answers to tell a broken resolver from a broken record.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| name | string | yes | – |
| password | – | – | – |
| port | integer | – | – |
| record_type | string | – | – |
| server | – | – | – |
| timeout | integer | – | – |
| use_dig | boolean | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_docker_images ~129
Collects docker images --digests output (repository, tag, digest, image ID, age, size) from a remote Linux host via SSH When the login user cannot reach the docker daemon (not root, not in the docker group), the command is run through passwordless sudo or doas (sudo -n / doas -n).
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_docker_inspect ~189
Inspects a SPECIFIC docker container, given by name or ID, on a remote Linux host via SSH. Returns a curated subset of docker inspect: image, entrypoint/cmd, state (status, exit code, OOMKilled, start/finish time, health check log), restart count and policy, memory/CPU limits, networks, ports, mounts and log driver. Environment variables are NOT returned. When the login user cannot reach the docker daemon (not root, not in the docker group), the command is run through passwordless sudo or doas (sudo -n / doas -n).
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| container | string | yes | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_docker_logs ~224
Gets the last `lines` log lines (stdout and stderr merged) of a SPECIFIC docker container, given by name or ID, from a remote Linux host via SSH. Works for stopped containers too. Use get_docker_ps_all first to find container names. Optional since limits them to a time window: '30 min ago', '2 hours ago', '30m', '1h30m' or 'YYYY-MM-DD HH:MM:SS' ('today' and 'yesterday' are not supported here). When the login user cannot reach the docker daemon (not root, not in the docker group), the command is run through passwordless sudo or doas (sudo -n / doas -n).
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| container | string | yes | – |
| host | string | yes | – |
| key_path | – | – | – |
| lines | integer | – | – |
| password | – | – | – |
| port | integer | – | – |
| since | – | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_docker_ps_all ~115
Collects docker ps --all output from a remote Linux host via SSH When the login user cannot reach the docker daemon (not root, not in the docker group), the command is run through passwordless sudo or doas (sudo -n / doas -n).
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_docker_stats ~136
Collects a one-shot docker stats snapshot from a remote Linux host via SSH: CPU %, memory usage/limit, network and block I/O, PIDs for every RUNNING container. When the login user cannot reach the docker daemon (not root, not in the docker group), the command is run through passwordless sudo or doas (sudo -n / doas -n).
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_failed_logins ~192
Lists recent FAILED login attempts (lastb, from btmp) on a remote Linux host via SSH, newest first: attempted user, terminal, source address, time. USE THIS TOOL to check for brute-force attempts. Requires root, since btmp is not world-readable: when the login user is not root, the command is run through passwordless sudo or doas (sudo -n / doas -n). Optional since limits them to a time window: '30 min ago', '2 hours ago', 'today', 'yesterday' or 'YYYY-MM-DD HH:MM:SS'.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| lines | integer | – | – |
| password | – | – | – |
| port | integer | – | – |
| since | – | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_free_memory ~76
Returns free memory, swap (total/free), page cache, HugePages and so on
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_hostname ~124
Collects the hostname of a remote Linux host via SSH, as the host itself reports it. Output: "hostname: <name>" (the kernel hostname, uname -n), then "fqdn: <name>" (hostname -f) when the host can resolve its fully qualified name; that line is absent otherwise.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_inode_usage ~75
Collects inode usage (df -i) from a remote Linux host via SSH.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_installed_packages ~317
Lists installed packages with versions on a remote Linux host via SSH, using the first available package manager. The FIRST output line starts with '#' and names the package manager and the columns; the rest is one package per line: dpkg (Debian/Ubuntu), tab-separated: package, version, architecture, status ('ii' installed, 'hi' installed and held), source_package, source_version. Security advisories for Debian/Ubuntu are keyed by SOURCE package (openssh, not openssh-server). Removed packages whose config files are left behind (state 'rc') are not listed. rpm (RHEL/Fedora/SUSE), tab-separated: package, epoch (0 if the package has none), version, release, architecture, source_rpm (file name of the source RPM, e.g. openssh-8.7p1-38.el9.src.rpm for openssh-server). Compare versions as epoch:version-release. Imported GPG keys (gpg-pubkey) are not listed. apk (Alpine), tab-separated: package, version, architecture, origin. Security advisories for Alpine are keyed by ORIGIN (openssl, not libcrypto3); it has the same version as the package.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_ip_addr ~88
Collects ip addr show output (network interfaces, their state, MAC, IPv4 and IPv6 addresses) from a remote Linux host via SSH
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_ip_route ~94
Collects the IPv4 and IPv6 routing tables (ip route show, ip -6 route show: default gateway, per-interface routes) from a remote Linux host via SSH
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_is_installed ~84
Checks whether a binary/command is installed and callable on a remote Linux host via SSH.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| binary | string | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_journal_errors ~184
Gets recent journald entries of priority warning and above (warning, err, crit, alert, emerg) from ALL units and the kernel. USE THIS TOOL FIRST when you don't know which service is at fault. With current_boot_only=True only entries since the last boot are returned. Optional since limits them to a time window: '30 min ago', '2 hours ago', 'today', 'yesterday' or 'YYYY-MM-DD HH:MM:SS' (the last `lines` entries within it are returned).
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| current_boot_only | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| lines | integer | – | – |
| password | – | – | – |
| port | integer | – | – |
| since | – | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_kernel_version ~83
Collects kernel name, release, build version and architecture (uname -srvm) from a remote Linux host via SSH
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_kubectl_describe ~234
Describes a SPECIFIC kubernetes resource (kubectl describe) by running kubectl on a remote Linux host via SSH: status, conditions, containers and its recent events. kubectl must be configured for the SSH user there. resource_type is one of: pod, node, namespace, deployment, statefulset, daemonset, replicaset, job, cronjob, service, endpoints, ingress, networkpolicy, persistentvolumeclaim, persistentvolume, storageclass, horizontalpodautoscaler, poddisruptionbudget (plural and short names like 'po', 'deploy', 'svc' work too). Secrets and configmaps are NOT available. namespace is ignored for cluster-scoped resources (node, namespace, persistentvolume, storageclass).
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| name | string | yes | – |
| namespace | string | – | – |
| password | – | – | – |
| port | integer | – | – |
| resource_type | string | yes | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_kubectl_events ~176
Gets the most recent `lines` kubernetes events (kubectl get events), oldest first, below the column header, by running kubectl on a remote Linux host via SSH. kubectl must be configured for the SSH user there. USE THIS TOOL FIRST when you don't know what is wrong in a cluster. Events of ALL namespaces are returned unless namespace is given. warnings_only=True keeps only events of type Warning (FailedScheduling, BackOff, Unhealthy...).
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| lines | integer | – | – |
| namespace | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
| warnings_only | boolean | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_kubectl_logs ~218
Gets the last `lines` log lines of a SPECIFIC kubernetes pod (kubectl logs) by running kubectl on a remote Linux host via SSH. kubectl must be configured for the SSH user there. container selects a container in a multi-container pod. previous=True returns logs of the previous, crashed instance - use it for CrashLoopBackOff. Optional since limits them to a time window: '30 min ago', '2 hours ago', '30m', '1h30m' or an absolute UTC time 'YYYY-MM-DDTHH:MM:SSZ'.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| container | – | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| lines | integer | – | – |
| namespace | string | – | – |
| password | – | – | – |
| pod | string | yes | – |
| port | integer | – | – |
| previous | boolean | – | – |
| since | – | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_last_logins ~214
Lists recent SUCCESSFUL logins (last, from wtmp) to a remote Linux host via SSH, newest first: user, terminal, source address, login/logout time. Also shows reboots. For failed login attempts use get_failed_logins. On BusyBox hosts (Alpine), where last takes no options, the output is plain `last` cut to `lines` rows: its first line starts with '# BusyBox', times have no year, and since is not supported (the tool fails with a message saying so). Optional since limits them to a time window: '30 min ago', '2 hours ago', 'today', 'yesterday' or 'YYYY-MM-DD HH:MM:SS'.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| lines | integer | – | – |
| password | – | – | – |
| port | integer | – | – |
| since | – | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_libc_version ~180
Collects C library implementation and version (glibc or musl) from a remote Linux host via SSH. Uses ldd --version; musl is detected by the presence of /lib/ld-musl-* loader. The last line, "package: <name> <version>", is the distro package version (e.g. 2.39-0ubuntu8.9, 2.34-289.el9, 1.2.6-r3) that security data is keyed by; it is taken from dpkg, rpm or apk and is absent on other distros.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_list_of_files ~91
Collects list of files for a specific abs path from a remote Linux host via SSH. Returns with -lah option
| Name | Type | Req | Description |
|---|---|---|---|
| abs_path | string | – | – |
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_list_of_files_with_filter ~106
Collects list of files for a specific abs path with filter (grep) applied from a remote Linux host via SSH. -lah option is applied.
| Name | Type | Req | Description |
|---|---|---|---|
| abs_path | string | – | – |
| accept_new_hostkey | boolean | – | – |
| filter | string | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_listening_sockets ~195
Collects ss -tulpn output (open ports and sockets) from a remote Linux host via SSH. If ss is not installed (e.g. Alpine), falls back to netstat -tulnp; the output then starts with a "# ss is not installed: netstat -tulnp" line and has netstat's columns. If the login user is not root, runs through sudo -n / doas -n to get the process names of all sockets; if that is not allowed, runs as the login user and says so in a "# not run as root" line (process names are then shown only for its own sockets).
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_lockfiles ~299
Finds dependency lockfiles under the given absolute app paths on a remote Linux host via SSH: composer.lock (PHP), package-lock.json, yarn.lock, pnpm-lock.yaml (Node.js), requirements*.txt, poetry.lock, uv.lock, Pipfile.lock (Python), Gemfile.lock (Ruby), go.sum (Go) and Cargo.lock (Rust). Skips node_modules, vendor, .git, venv and .venv directories. Lists the files found with size and mtime (ls -l). With include_contents=True prints the files instead (the first 20 found), each after a '===== <path> (<size> bytes) =====' line. A file is always printed WHOLE or not at all, never cut: a file over 5 MB, or one that would take the output over 10 MB in total, gets a '===== <path> (skipped: ...) =====' line instead. The output can be several MB - call without include_contents first to see the sizes, then narrow abs_paths to the application you need.
| Name | Type | Req | Description |
|---|---|---|---|
| abs_paths | array | yes | – |
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| include_contents | boolean | – | – |
| key_path | – | – | – |
| max_depth | integer | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_lsblk ~71
Collects lsblk output from a remote Linux host via SSH
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_memory_pressure ~84
DEPRECATED: use get_pressure, which returns CPU, I/O and memory pressure in one call. Returns memory pressure if supported
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_mounts ~156
Lists mounted filesystems with their mount point, source device, filesystem type and mount options (findmnt, as a tree; /proc/mounts if findmnt is not installed). USE THIS TOOL to find a filesystem that was remounted read-only after an error ('ro' in the options), to check options like noexec/nosuid, and to see network (nfs, cifs), overlay and tmpfs mounts. For free space use get_disk_free instead.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_php_info ~131
Collects PHP details from a remote Linux host via SSH: CLI version and SAPI, installed CGI (php-cgi) and FPM (php-fpm) binaries with their versions/SAPIs, whether php-fpm or php-cgi processes are currently running, and, if Apache is installed, whether mod_php is enabled in its config and loaded.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_pressure ~196
Returns Linux pressure stall information (PSI) for CPU, I/O and memory in one call. USE THIS TOOL to tell which resource the host is short of: unlike load average, it shows how much time tasks actually spent waiting for each resource. 'some' = share of time at least one task was stalled, 'full' = all non-idle tasks were stalled at once; avg10/avg60/avg300 are percentages over the last 10, 60 and 300 seconds, total is the cumulative stall time in microseconds. Prints 'PSI not supported' for a resource if the kernel is older than 4.20 or PSI is disabled.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_process_files ~390
Shows which packages' code every running process executes on a remote Linux host via SSH: its executable, the shared libraries it has loaded, and the package that owns each of those files. USE THIS TOOL to find which services really use a library (e.g. is the vulnerable libssl loaded by anything that listens on the network?) and which processes still run a binary or library that was replaced by an upgrade and need a restart. Combine the pids with get_listening_sockets. The output has two parts, tab-separated: 1. Per process a line "P <pid> <name> <executable>", followed by one line "F <file>" for every file it has mapped as executable code (read from /proc/<pid>/maps). 2. After a line starting with "# owners": the package of each of those files. rpm and apk: "<package> <file>". dpkg: "<package>[:arch][, <package>...]: <file>", as printed by dpkg-query -S. A file missing here belongs to no package. With a merged /usr a file may be listed as /lib/... or /bin/... where part 1 says /usr/lib/... or /usr/bin/..., or the other way round. If the login user is not root, part 1 runs through sudo -n / doas -n to see all processes; if that is not allowed, it runs as the login user and says so in a "# not run as root" first line (only that user's own processes are then listed).
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_ps_aux_top_cpu_consumers ~143
Lists top 10 cpu consumers, CPU desc (ps aux --sort=-%cpu). On BusyBox hosts (Alpine), where ps cannot sort, the output comes from `top -b -n 1` instead: its first line starts with '# BusyBox', the columns differ, and %CPU is the usage at this moment, not the average over the process lifetime that ps reports.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_ps_aux_top_mem_consumers ~143
Lists top 10 mem consumers, MEM desc (ps aux --sort=-%mem). On BusyBox hosts (Alpine), where ps cannot sort and has no %MEM, the output is `ps -o pid,user,rss,vsz,args` sorted by RSS instead: its first line starts with '# BusyBox' and sizes are in KB unless they carry an m or g suffix.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_new_hostkey | boolean | – | – |
| host | string | yes | – |
| key_path | – | – | – |
| password | – | – | – |
| port | integer | – | – |
| timeout | integer | – | – |
| user | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
How do I install the io.github.Areso/safe-ssh-mcp server?
io.github.Areso/safe-ssh-mcp runs locally as a PyPI package, launched with uvx safe-ssh-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · safe-ssh-mcp
claude mcp add areso-safe-ssh-mcp -- uvx safe-ssh-mcp
What is the io.github.Areso/safe-ssh-mcp server?
io.github.Areso/safe-ssh-mcp is listed in the public MCP registry as io.github.Areso/safe-ssh-mcp. A secured scoped SSH MCP server for executing safe read-only diagnostic DevOps / SysOps commands. This page covers its PyPI package (safe-ssh-mcp).
Is the io.github.Areso/safe-ssh-mcp server safe to use?
io.github.Areso/safe-ssh-mcp scores 77 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 22 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.Areso/safe-ssh-mcp server expose?
io.github.Areso/safe-ssh-mcp exposes 56 tools: get_disk_free, get_inode_usage, get_disk_usage, get_list_of_files, get_list_of_files_with_filter, and 51 more. Their descriptions and schemas cost roughly 8,488 tokens of context every time the server is loaded.
Is the io.github.Areso/safe-ssh-mcp server still maintained?
io.github.Areso/safe-ssh-mcp is still listed as active in the MCP registry. We last reached this channel on 22 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.Areso/safe-ssh-mcp server under?
io.github.Areso/safe-ssh-mcp declares the AGPL-3.0-or-later licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.
What did VerifyMCP test on the io.github.Areso/safe-ssh-mcp server?
VerifyMCP ran 16 checks on io.github.Areso/safe-ssh-mcp, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.