Terminal Guardian MCP Server

terminal-guardian-mcp npm v1.5.0

Published by 7majesty-m — no publish provenance, so origin is unverified, but the source is public: the repository link below is self-declared yet readable, so you can inspect the code before adopting it.

Secure Model Context Protocol server for safe, sandboxed terminal access for AI assistants

Trust grade
B
87/100
Last scanned get badge →
Trust
B · 87/100
Adoption risk for you: the threat score, then adjusted down for blast radius, publisher verification and how much the scan could see. Deterministic; every point is auditable.
Capability
High
Blast radius if it went rogue — what the server’s tools could reach. Independent of trust.
Coverage
Source
How much the scan could actually inspect. Shallow coverage is stated, never hidden.
Share this Trust Score
𝕏 Share LinkedIn Reddit
B Why this grade threat 94 − adoption risk = 87/100

The grade answers one question — how safe is this server for you to adopt — so it is computed in two auditable stages. Nothing below is an opinion or an LLM's guess; every line is a real term the deterministic engine applied, and the same input always yields the same number.

1. Threat score — 100 − 6.3 = 94. What the published surface and source actually contain:

PointsWhat was foundCategory
−6.3 Untrusted input concatenated into a command sink MTC-SRC-009 injection

2. Client adoption risk — 94 − 7 = 87. Three small, subtract-only factors that reflect your risk in adopting it — a clean scan proves less on a powerful, unverified or barely-inspectable package, so the grade says so plainly:

PointsAdoption-risk factor
−6 capability blast radius (high) — client exposure if the model is manipulated
−1 publisher verification (public source) — no provenance, but the source is public and inspectable

Capability observations and info notes are shown under Findings but never scored. Open any row's finding below for the file, line and evidence behind a deduction.

Findings 22

high Sensitive-source and external-sink co-existMTC-FLOW-004

Tools that read sensitive data ([list_files, read_file, get_env]) and tools that can send data out ([run_command, analyze_command, http_request, docker_exec, ssh_exec]) are exposed together. An agent can move private data to the sink.

Evidence: sources [list_files, read_file, get_env] → sinks [run_command, analyze_command, http_request, docker_exec, ssh_exec]

Fix: Keep secret-reading and egress capabilities on separate, separately-approved servers.

Location: flow list_files → run_command

high Tool "run_command" exposes command/code executionMTC-CAP-001

Tool "run_command" appears to run shell commands or evaluate code (keyword "run_command" in tool name, parameter "command"). Arbitrary execution driven by model input is one of the most dangerous MCP capabilities; combined with any untrusted input it becomes RCE.

Fix: Sandbox execution, allowlist commands/arguments, and never pass model output to a shell unescaped.

Location: tool run_command

high Tool "analyze_command" exposes command/code executionMTC-CAP-001

Tool "analyze_command" appears to run shell commands or evaluate code (parameter "command"). Arbitrary execution driven by model input is one of the most dangerous MCP capabilities; combined with any untrusted input it becomes RCE.

Fix: Sandbox execution, allowlist commands/arguments, and never pass model output to a shell unescaped.

Location: tool analyze_command

high Tool "docker_exec" exposes command/code executionMTC-CAP-001

Tool "docker_exec" appears to run shell commands or evaluate code (keyword "exec" in tool name, parameter "command"). Arbitrary execution driven by model input is one of the most dangerous MCP capabilities; combined with any untrusted input it becomes RCE.

Fix: Sandbox execution, allowlist commands/arguments, and never pass model output to a shell unescaped.

Location: tool docker_exec

high Tool "ssh_exec" exposes command/code executionMTC-CAP-001

Tool "ssh_exec" appears to run shell commands or evaluate code (keyword "exec" in tool name, parameter "command"). Arbitrary execution driven by model input is one of the most dangerous MCP capabilities; combined with any untrusted input it becomes RCE.

Fix: Sandbox execution, allowlist commands/arguments, and never pass model output to a shell unescaped.

Location: tool ssh_exec

high Shell/command execution in server code (dist/git/manager.js)MTC-SRC-002

In the server's implementation (`dist/git/manager.js:1`): Spawning a shell/process is command-execution capability; with unsanitized tool input it is command injection / RCE. This is read from the code itself — not from the tool description — so a poisoned server cannot hide it behind honest-looking metadata.

Evidence: port { execSync } from 'child_process'; import { existsSync } from 'fs'; import { resolve, join } from 'path'; export cl

Fix: Review this call path: confirm it never receives unsanitized tool input, constrain it, or remove it. Treat a server whose code reaches these sinks as high-capability regardless of what its tools claim.

Location: server dist/git/manager.js

high Shell/command execution in server code (dist/network/diagnostics.js)MTC-SRC-002

In the server's implementation (`dist/network/diagnostics.js:5`): Spawning a shell/process is command-execution capability; with unsanitized tool input it is command injection / RCE. This is read from the code itself — not from the tool description — so a poisoned server cannot hide it behind honest-looking metadata.

Evidence: execSync, spawn } from 'child_process'; import { URL } from 'url'; const IS_WINDOWS = process.platform === 'win32'; cons

Fix: Review this call path: confirm it never receives unsanitized tool input, constrain it, or remove it. Treat a server whose code reaches these sinks as high-capability regardless of what its tools claim.

Location: server dist/network/diagnostics.js

high Shell/command execution in server code (dist/tools/executor.js)MTC-SRC-002

In the server's implementation (`dist/tools/executor.js:1`): Spawning a shell/process is command-execution capability; with unsanitized tool input it is command injection / RCE. This is read from the code itself — not from the tool description — so a poisoned server cannot hide it behind honest-looking metadata.

Evidence: import { spawn } from 'child_process'; import { resolve, isAbsolute } from 'path'; import { existsSync } from 'fs'; imp

Fix: Review this call path: confirm it never receives unsanitized tool input, constrain it, or remove it. Treat a server whose code reaches these sinks as high-capability regardless of what its tools claim.

Location: server dist/tools/executor.js

high Shell/command execution in server code (dist/tools/processManager.js)MTC-SRC-002

In the server's implementation (`dist/tools/processManager.js:5`): Spawning a shell/process is command-execution capability; with unsanitized tool input it is command injection / RCE. This is read from the code itself — not from the tool description — so a poisoned server cannot hide it behind honest-looking metadata.

Evidence: port { execSync } from 'child_process'; const IS_WINDOWS = process.platform === 'win32'; // ── Listing ─────────────────

Fix: Review this call path: confirm it never receives unsanitized tool input, constrain it, or remove it. Treat a server whose code reaches these sinks as high-capability regardless of what its tools claim.

Location: server dist/tools/processManager.js

medium Hardcoded egress to an external endpoint (dist/git/commitGenerator.js)MTC-SRC-003

In the server's implementation (`dist/git/commitGenerator.js:69`): A hardcoded outbound call to a fixed external host inside server code is a classic exfiltration/telemetry channel — especially paired with reads of local data. This is read from the code itself — not from the tool description — so a poisoned server cannot hide it behind honest-looking metadata.

Evidence: const response = await fetch('https://api.anthropic.com/v1/messages', { method: 'POST', headers: {

Fix: Review this call path: confirm it never receives unsanitized tool input, constrain it, or remove it. Treat a server whose code reaches these sinks as high-capability regardless of what its tools claim.

Location: server dist/git/commitGenerator.js

medium Untrusted input concatenated into a command sink (dist/tools/processManager.js)MTC-SRC-009

In the server's implementation (`dist/tools/processManager.js:107`): A shell/process command assembled from concatenated or interpolated values is command injection when any part is attacker-influenced — the OWASP canonical RCE flow. Verify what reaches the interpolated value. This is read from the code itself — not from the tool description — so a poisoned server cannot hide it behind honest-looking metadata.

Evidence: '/f' : ''; execSync(`taskkill ${flag} /pid ${pid}`, { timeout: 5000 }); } else {

Fix: Review this call path: confirm it never receives unsanitized tool input, constrain it, or remove it. Treat a server whose code reaches these sinks as high-capability regardless of what its tools claim.

Location: server dist/tools/processManager.js

medium Unconstrained URL/host parameter "url" on "http_request"MTC-CAP-007

Tool "http_request" takes a URL/host parameter "url" with no allowlist/pattern. An outbound-request tool with an unbounded destination enables SSRF and cloud-metadata access (e.g. 169.254.169.254).

Fix: Allowlist destinations or constrain the parameter; block private/link-local addresses server-side.

Location: tool http_request · inputSchema.properties.url

medium Unconstrained command parameter "command" on "run_command"MTC-CAP-006

Tool "run_command" takes a command-shaped parameter "command" with no enum/pattern constraint. Free-form, model- or attacker-controlled arguments reaching a shell is the command-injection precondition.

Fix: Constrain the parameter (enum/pattern), or build the command from a fixed template with escaped args.

Location: tool run_command · inputSchema.properties.command

medium Unconstrained command parameter "command" on "analyze_command"MTC-CAP-006

Tool "analyze_command" takes a command-shaped parameter "command" with no enum/pattern constraint. Free-form, model- or attacker-controlled arguments reaching a shell is the command-injection precondition.

Fix: Constrain the parameter (enum/pattern), or build the command from a fixed template with escaped args.

Location: tool analyze_command · inputSchema.properties.command

medium Unconstrained command parameter "command" on "docker_exec"MTC-CAP-006

Tool "docker_exec" takes a command-shaped parameter "command" with no enum/pattern constraint. Free-form, model- or attacker-controlled arguments reaching a shell is the command-injection precondition.

Fix: Constrain the parameter (enum/pattern), or build the command from a fixed template with escaped args.

Location: tool docker_exec · inputSchema.properties.command

medium Unconstrained command parameter "command" on "ssh_exec"MTC-CAP-006

Tool "ssh_exec" takes a command-shaped parameter "command" with no enum/pattern constraint. Free-form, model- or attacker-controlled arguments reaching a shell is the command-injection precondition.

Fix: Constrain the parameter (enum/pattern), or build the command from a fixed template with escaped args.

Location: tool ssh_exec · inputSchema.properties.command

low Mutating tool "run_command" declares no destructiveHintMTC-CAP-005

Tool "run_command" can mutate/egress but declares no destructiveHint. Clients that don't default to spec-safe behavior may not prompt before running it.

Fix: Declare accurate annotations, and gate destructive tools on user confirmation regardless.

Location: tool run_command

low Mutating tool "analyze_command" declares no destructiveHintMTC-CAP-005

Tool "analyze_command" can mutate/egress but declares no destructiveHint. Clients that don't default to spec-safe behavior may not prompt before running it.

Fix: Declare accurate annotations, and gate destructive tools on user confirmation regardless.

Location: tool analyze_command

low Mutating tool "docker_exec" declares no destructiveHintMTC-CAP-005

Tool "docker_exec" can mutate/egress but declares no destructiveHint. Clients that don't default to spec-safe behavior may not prompt before running it.

Fix: Declare accurate annotations, and gate destructive tools on user confirmation regardless.

Location: tool docker_exec

low Mutating tool "ssh_exec" declares no destructiveHintMTC-CAP-005

Tool "ssh_exec" can mutate/egress but declares no destructiveHint. Clients that don't default to spec-safe behavior may not prompt before running it.

Fix: Declare accurate annotations, and gate destructive tools on user confirmation regardless.

Location: tool ssh_exec

low Unconstrained path parameter "path" on "list_files"MTC-CAP-008

Tool "list_files" takes a path parameter "path" with no constraint. Without a canonicalize-and-contain check (not visible statically), this permits ../ traversal outside the intended root.

Fix: Resolve and verify the path stays within an allowed root; reject traversal sequences.

Location: tool list_files · inputSchema.properties.path

low Unconstrained path parameter "path" on "read_file"MTC-CAP-008

Tool "read_file" takes a path parameter "path" with no constraint. Without a canonicalize-and-contain check (not visible statically), this permits ../ traversal outside the intended root.

Fix: Resolve and verify the path stays within an allowed root; reject traversal sequences.

Location: tool read_file · inputSchema.properties.path

Tools 28

Each tool and what it can reach — statically extracted from the published source.

  • analyze_commandruns code / shell
  • docker_execruns code / shell
  • get_envreads sensitive data
  • http_requestnetwork egress
  • list_filesreads sensitive data
  • read_filereads sensitive data
  • run_commandruns code / shell
  • ssh_execruns code / shell
  • apply_templateno sensitive capability
  • dns_lookupno sensitive capability
Show 18 more tools ↓
  • docker_logsno sensitive capability
  • docker_psno sensitive capability
  • docker_statsno sensitive capability
  • Express.js REST APIno sensitive capability
  • git_diffno sensitive capability
  • git_logno sensitive capability
  • git_statusno sensitive capability
  • git_suggest_commitno sensitive capability
  • hellono sensitive capability
  • kill_processno sensitive capability
  • list_processesno sensitive capability
  • list_templatesno sensitive capability
  • pingno sensitive capability
  • Python CLI Toolno sensitive capability
  • Python FastAPIno sensitive capability
  • search_filesno sensitive capability
  • ssh_list_profilesno sensitive capability
  • ssh_testno sensitive capability

Toxic flows 1

Cross-tool combinations that form a data-exfiltration primitive (untrusted input → sensitive source → external sink).

What this scan could not see

Versions 1

Scan history per published version. The engine is deterministic — the same version always yields the same score, so a changed score means the package itself changed.

VersionScoreFindingsEngineScanned
v1.5.0 latest B 87/100 22 1.13.0 2026-09-07

Embed this score

Show this server's live Trust Score in your README, docs or website. The badge is served straight from the registry and updates automatically after every rescan — no API key needed. It links back to this page, so anyone who sees the grade can also read the findings behind it instead of taking a number on faith.

MCP Trust Score: B · 87/100
Markdown (GitHub README)
[![MCP Trust Score](https://mcptrustchecker.com/registry/terminal-guardian-mcp/badge.svg)](https://mcptrustchecker.com/registry/terminal-guardian-mcp)
HTML
<a href="https://mcptrustchecker.com/registry/terminal-guardian-mcp"><img src="https://mcptrustchecker.com/registry/terminal-guardian-mcp/badge.svg" alt="MCP Trust Score" height="20"></a>
Prefer shields.io styling? Point it at https://mcptrustchecker.com/registry/terminal-guardian-mcp/badge.json via https://img.shields.io/endpoint?url=…

Verify this score yourself

The score above is reproducible: the same package version always yields the same result. Run it locally or over the free API — no account, no LLM, fully deterministic.

npx mcptrustchecker scan terminal-guardian-mcp --online

Use the free API → How scoring works

More in Developer Tools