claude-remote-mcp-agent-bridge@0.2.1
CAUTION· not startedPublisher claims: "Stateless HTTP service on the agent host that drives the herdr CLI" Observed in sandbox: no network, touches nothing outside the project, writes no memory.
Coverage
Not started: dependency install failed; the server itself was not observed.- Tested
- the dependency install step · every file read, file written and host contacted by what ran
- Not tested
- server startup · the tool list · tool behavior
What this means for the label: Caution here covers what ran. The server's tools were not exercised with a real credential, so nothing about their behavior is asserted; the credential summary below says what to do with that.
Before you give it your token
- It will ask for
- no credential variables read in the code
- Where it talks to
- no vendor host named in the codeAlso microsoft.com — not the publisher's domain; check what for before connecting.
- What the honeypot saw
- no credential files read · no network
- What we could not test
- server startup · the tool list · tool behavior
Connect it under the guard. Not started: dependency install failed; the server itself was not observed. The code names no credential variable; the guard pins the network to what the honeypot saw and logs every call.
Never paste a credential into a chat, a ticket or a report, including ours. How the guard holds it.
Is [email protected] safe to install?
KillerSkills ran it in the KillerSkills honeypot sandbox (2 scenarios; not started: dependency install failed; the server itself was not observed) on 2026-11-18 and scored it 72/100 (Caution). It is not known to be malicious, but it has behaviour or code a security policy should decide on before install. Notable findings: Privileged sudo command; Access to sensitive file paths; Access to sensitive file paths. Summary: no network, touches nothing outside the project, writes no memory.
Behavior trace
Honeypot run · 0 s · 2 scenarios · 0 deviationsStatic findings
setup.add_argument("--enrollment", metavar="STRING", help="what `sudo mcp-gateway enroll` printed; '' to enroll later")Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.LEGACY_ENV_FILE = ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# No env_file here: only from_env() reads `.env`, so constructing Settings directlyFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.f"at boot. Turn it on with:\n sudo loginctl enable-linger {self.system.user()}")Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell."That isn't an enrollment string. Run `sudo mcp-gateway enroll` on the gateway host; "Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.f"sudo mcp-gateway bridges rename {now or gateway.name} {name}")Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.return subprocess.run(argv, capture_output=True, text=True).stdoutFix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.result = subprocess.run([self.command(), *args], env=environment, cwd="/", text=True, **captured)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out."the gateway may not reach it. To enroll again, run `sudo mcp-gateway enroll` on the "Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.# What `sudo mcp-gateway enroll` prints: crm1@<address>:<port>#<secret>.Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell."(with a new string from `sudo mcp-gateway enroll` once this one expires):", file=sys.stderr)Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.return subprocess.run(["systemctl", "--user", *args], capture_output=True).returncodeFix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.would, in UTF-8 mode and away from a .env in the current folder."""Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.by_hand = f"if this host was enrolled, remove it on the gateway host with: sudo mcp-gateway bridges remove {name or '<name>'}"Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell."sudo mcp-gateway bridges remove <name> (see sudo mcp-gateway bridges list)")Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell."""systemd starts a user unit in the home folder, where serve still reads a .env (theFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."not through su or sudo -u")Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.legacy = self.system.home / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."""Whether a file has AGENT_BRIDGE_* lines; a checkout's .env may be mcp-gateway's."""Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.by_hand = f"Rename it on the gateway host with: sudo mcp-gateway bridges rename {gateway.name} {name}"Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.enroll_command.add_argument("string", help="what `sudo mcp-gateway enroll` printed, crm1@…")Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.print("\nTo enroll with the gateway, run on the gateway host: sudo mcp-gateway enroll", file=sys.stderr)Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.raise Refused("--rotate-token needs an enrollment string, so the gateway learns the new token: run sudo "Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.assert "sudo mcp-gateway bridges remove mac" in errFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.(host.home / ".env").write_text("AGENT_BRIDGE_MAX_AGENTS=abc\n")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.assert "sudo mcp-gateway bridges remove neura" in capsys.readouterr().errFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.subprocess.run([pythonw, script, out], env=env, timeout=60, check=True)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.assert "sudo loginctl enable-linger me" in run.outFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.return subprocess.run(["loginctl", "enable-linger", self.user()], capture_output=True).returncode == 0Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.assert "sudo mcp-gateway bridges rename mac studio" in errFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.result = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.return subprocess.run(argv, capture_output=True, creationflags=subprocess.CREATE_NO_WINDOW).stdout.decode(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.return f"mode {mode:o}; chmod 600 it" if mode & 0o077 else NoneFix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts.assert "sudo mcp-gateway enroll" in errFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.assert "sudo mcp-gateway bridges remove mac" in errFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.assert "sudo mcp-gateway bridges rename mac studio" in errFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.Path(".env").write_text("MCP_GATEWAY_PUBLIC_HOST=mcp.example.com\n")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# --- Settings in ~/.env, which serve reads in the unit's working folder ----------------Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# from_env reads .env from the working directory; start each test without one.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# A checkout's .env may be mcp-gateway's: no warning for that.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.result = subprocess.run([_system32("schtasks.exe"), "/Query", "/TN", f"\\{TASK}", "/XML"], capture_output=True,Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.assert response.json()["error"]["code"] == "bad_output"Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.assert f"also reads the settings in {host.home / '.env'}" in run.outFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.return subprocess.run([_system32("schtasks.exe"), *args], capture_output=True,Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.(host.home / ".env").write_text("AGENT_BRIDGE_MAX_AGENTS=3\nOTHER=x\n")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.Path(".env").write_text("AGENT_BRIDGE_MAX_AGENTS=4\nAGENT_BRIDGE_HERDR_BIN=/opt/herdr\nOTHER=x\n")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.result = subprocess.run([self.command(), *args], env=environment, cwd=tempfile.gettempdir(),Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.assert any("chmod 600" in line for line in lines) == (os.name == "posix")Fix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts.Path(".env").write_text("AGENT_BRIDGE_NAME=old\nAGENT_BRIDGE_PORT=9000\n")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.return subprocess.run(["launchctl", *args], capture_output=True).returncodeFix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.assert f"with the settings in {host.home / '.env'}" in run.outFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.process = subprocess.Popen([sys.executable, "-c", "import time; time.sleep(60)"], env=env)Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.assert "enrolled with the gateway at http://10.0.0.1:8766 as neura" in run.outFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.GATEWAY = "http://192.168.1.10:8766"Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.mac.gateway_name = "studio-2" # sudo mcp-gateway bridges rename studio studio-2Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.return 1, "FAIL agent-bridge answers at http://192.168.1.20:8765 (ConnectError)\n"Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert "enrolled with the gateway at http://10.0.0.1:8766 as dell" in run.outFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert "enrolled with the gateway at http://10.0.0.1:8766 as dell" in run.outFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert "enrolled with the gateway at http://10.0.0.1:8766 as studio" in run.outFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls."gateway": {"url": "http://10.0.0.1:8766", "gateway_id": "g1", "name": name}}))Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert "enrolled with the gateway at http://10.0.0.1:8766 as neura" in run.outFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert "enrolled with the gateway at http://10.0.0.1:8766 as dell" in run.outFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls."gateway": {"url": "http://10.0.0.1:8766", "gateway_id": "g1", "name": name}}))Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert "sudo mcp-gateway bridges remove studio" in outFix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.assert "Done. agent-bridge listens on http://192.168.1.20:8765 and starts at every logon." in run.outFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls."gateway": {"url": "http://10.0.0.1:8766", "gateway_id": "g1", "name": name}}))Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert re.fullmatch(r"\d{4}-\d\d-\d\d \d\d:\d\d:\d\d INFO Uvicorn running on http://192.168.1.20:8765", lines[2])Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert "enrolled with the gateway at http://10.0.0.1:8766 as studio" in run.outFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.logging.getLogger("uvicorn.error").info("Uvicorn running on http://192.168.1.20:8765")Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.return 0, "ok agent-bridge answers at http://192.168.1.20:8765\n" + self._gateway_check()Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert settings.url == "http://192.168.1.20:9000"Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert fake.body() == {"secret": "a" * 24, "bridge_id": state.bridge_id, "url": "http://192.168.1.20:8765",Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert "enrolled with the gateway at http://10.0.0.1:8766 as neura" in run.outFix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.@pytest.mark.parametrize("string", ["[email protected]:8766", "http://192.168.1.10:8766", "crm1@host:8766#xyz"])Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.Cost to the agent
Tokens estimated at four characters each. The tool list is re-read by the agent on every turn, so it is the number to compare between servers that do the same job: ranked across the index.
Known vulnerabilities
Not checked against OSV yet; the weekly check has not reached this version.
What would make this Verified
8 points to 80 · weights: behavior 45%, static 25%, prompt 15%, publisher 15%- Unclaimed publisher≈ +8 on the totalClaim placheckij: a verified publisher gets +50 on publisher trust. It is free and usually instant with GitHub sign-in.
- Privileged sudo command≈ +4 on the totalBuild commands from fixed arguments; do not interpolate untrusted strings into a shell.
- Access to sensitive file paths≈ +4 on the totalStop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
- Python subprocess execution detected≈ +2 on the totalBuild commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
- File permission modification command≈ +2 on the totalRequest the narrowest permission that works; replace wildcards with the exact paths or hosts.
- File type combined with upload action≈ +2 on the totalRemove the call, or declare the host in frontmatter and explain in the README what is sent and why.