mcp-relay@0.1.1
CAUTION· not startedPublisher claims: "Use your local MCP servers from a cloud AI agent through one authenticated endpoint" Observed in sandbox: calls astral.sh only, touches nothing outside the project, writes no memory.
Coverage
Not started: dependency install failed; the server itself was not observed.- Tested
- install scripts, with decoy credentials in place · second launch with the clock 45 days ahead · 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
RELAY_CLIENT_TOKENor--client-tokenConfiguration, not credentials: MCP_RELAY_SKIP_PATH_UPDATE, RELAY_CLIENT_WORKSPACE, RELAY_URL- Where it talks to
- no vendor host named in the codeAlso astral.sh — not the publisher's domain; check what for before connecting.
- What the honeypot saw
- no credential files read · reached only astral.sh
- What we could not test
- server startup · the tool list · tool behavior
Connect it with a scoped credential, under the guard, and read the third-party hosts first. The code names astral.sh as well as its own vendor. The guard injects RELAY_CLIENT_TOKEN only into requests to the host you bind (and its subdomains) and refuses the rest.
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 (3 scenarios; not started: dependency install failed; the server itself was not observed) on 2026-11-08 and scored it 68/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: Access to sensitive file paths; Access to sensitive file paths; Access to sensitive file paths. Summary: calls astral.sh only, touches nothing outside the project, writes no memory.
Behavior trace
Honeypot run · 1 s · 3 scenariosStatic findings
printf 'Skipping interactive onboarding. For unattended deployment, supply ~/.mcp-relay/config.yaml and Server/Client environment variables (or private ~/.mcp-relay/.env) yourself.\n'Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.intent is an MCP token or Server topology key. A present .env is inspectedFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.raise config.ConfigError("tokens are not managed by the relay; set them in the process environment or .env yourself")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."""Reload and validate the written .env the way ``_report`` does for YAML.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.curl -fsSL https://astral.sh/uv/install.sh | shFix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out."""Authentication helpers for untrusted relay credentials."""Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.lines = ["Server (.env)", *issues]Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.print(f"Server\n[ERROR] .env is invalid ({error})\nresult=invalid")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# .env was exported, silently dead — Windows bench 2026-09-09). ConsumersFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.#: Credentials are read directly from the .env by their own loaders; theyFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.credential material lives in the alias private ``.env`` and is read at spawnFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.Read on every emission so a level exported from a ``.env`` file duringFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."""Mask relay tokens and credential-like keys in config show/get output.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# No skips: the fs bench fails the job if node/npx or the pinnedFix: Pin versions and sources; vendor anything fetched at install time.The value is read on every emission so a level exported from a ``.env`` fileFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.#: the YAML key, the private ``.env`` file, and the client-side catalog key,Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."--client-token is unsafe; use RELAY_CLIENT_TOKEN, .env, "Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.&& rm -rf /var/lib/apt/lists/* \Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.raise ConfigError(".env file is unavailable") from excFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.raise ConfigError(".env file is not a private regular file")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.DOTENV_FILENAME = ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.(pinned) spawned via node from a pre-warmed npx cache:Fix: Pin versions and sources; vendor anything fetched at install time.warm = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.The relay NEVER writes the .env: no key generation at init, no CLIFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# The relay never writes the .env; tests play the operator role.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.return subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.# network. Keep credentials in the ignored .env file, never in this file.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.help_result = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.# An explicit process variable wins over the .env fallback.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.(tmp_path / ".env").chmod(0o600)Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.help_result = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.equal_port_result = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.curl -fsSL https://astral.sh/uv/install.sh | shFix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.# it actually finishes because Python cannot force-kill an in-process task.Fix: 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.# Direct pop, NOT monkeypatch.delenv: the loader exports .env entriesFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.token_file = tmp_path / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.dotenv = config_path.parent / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.dotenv = relay_dir / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.os.symlink(outside / ".env", config_dir / ".env")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.…p_path / "config.yaml" path.write_text("not: [valid YAML") (tmp_path / ".env").write_text('RELAY_CLIENT_TOKEN=client-test-synthetic-credential-0000000000000…Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.alias_env = home / ".mcp-relay" / "mcp" / f"{ALIAS}.env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.client_proc = subprocess.Popen(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.server_proc = subprocess.Popen(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.dotenv = config_path.parent / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."""The .env file is a flat operator override surface (python-dotenv based).Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# An explicit process variable wins over the .env fallback.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.Any entry except the relay credentials becomes a process environmentFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.assert not (outside / ".env").exists()Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."resource": {"uri": "file:///etc/passwd", "text": "secret"},Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.pytest.param("http://203.0.113.17:9999", id="arbitrary-ip"),Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.# Same relay home parent that holds the per-alias .env filesFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.text = (ROOT / ".env.example").read_text()Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.no package-import hook (the removed import-time application made .envFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# Environment wins over the .env value just written.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.The bench never skips: a missing node/npx or a failed cache warm-up is aFix: Pin versions and sources; vendor anything fetched at install time.dotenv = config_path.parent / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.result = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.("/etc/passwd", "filesystem path"),Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."resource": {"uri": "https://user:[email protected]/x"},Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.exports the .env (shell wins) into ``os.environ``, then resolves theFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.with pytest.raises(config.ConfigError, match=r"RELAY_CLIENT_TOKEN|\.env"):Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.assert {".git", ".env", ".venv", "tests/"} <= ignoredFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.dotenv = config_path.parent / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# per-alias .env files (never inside the workspace); the launcher runsFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.(tmp_path / ".env").write_text(f"RELAY_CLIENT_TOKEN={CLIENT}\nRELAY_MCP_TOKEN={MCP}\n")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# The .env must exist before init: init_config verifies the client tokenFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."""Locate the warmed package's JS entry inside the npx cache."""Fix: Pin versions and sources; vendor anything fetched at install time.return config_path.parent / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.npx = shutil_which("npx")Fix: Pin versions and sources; vendor anything fetched at install time.f"{FS_PACKAGE} entry point not found in warmed npx cache {cache}"Fix: Pin versions and sources; vendor anything fetched at install time.pytest.param("http://203.0.113.17:9999", id="arbitrary-ip"),Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.result = subprocess.run(Fix: Build commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.credential_uri = "https://user:[email protected]/resource?token=top-secret"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.(tmp_path / ".env").chmod(0o600)Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.# Effective client port -> relay_url derivation (env > .env > default 8001)Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose."http://192.168.1.41:8000",Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.assert (tmp_path / ".env").exists() == (source == "dotenv")Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.dotenv = tmp_path / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.dotenv = tmp_path / ".env"Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.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
No advisories in OSV for mcp-relay@0.1.1 as of 6d ago. This is the package itself, not its dependencies.
What would make this Verified
12 points to 80 · weights: behavior 45%, static 25%, prompt 15%, publisher 15%- Pipe-to-shell pattern≈ +9 on the totalBuild commands from fixed arguments, never from interpolated strings; prefer an API client over shelling out.
- Unclaimed publisher≈ +8 on the totalClaim kxlion: a verified publisher gets +50 on publisher trust. It is free and usually instant with GitHub sign-in.
- 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.
- Credential pass-through configuration≈ +4 on the totalStop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
- npx invocation of non-well-known package≈ +2 on the totalPin versions and sources; vendor anything fetched at install time.
- Destructive file system command detected≈ +2 on the totalBuild commands from fixed arguments; do not interpolate untrusted strings into a shell.