Grades are a hygiene check, not a security guarantee.

MCP, MCP server

rpc

TypeScript RPC for a network of peers — a browser tab, a Node service, and a plant full of devices — over WebSocket and MQTT 5, with one programming model across all of them.

Compatibility: Not stated.

Grade D

Two or more Medium findings, or a High. Only try it in a sandbox.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

PERMISSION_SHELL_UNDECLARED OBFUSCATION_ENCODED_BLOB

Why this grade

  • PERMISSION_SHELL_UNDECLARED Medium

    Runs shell commands that the manifest or description does not mention.

    packages/cli/src/packages.ts, line 15 * could `child_process.exec('npm i …')` on its own. Putting it behind a second flag would be theatre;

  • OBFUSCATION_ENCODED_BLOB Medium

    Contains a long base64 shaped string in a file that should be readable.

    CHANGELOG.md, line 1 # Changelog

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

If you think this grade is wrong, email [email protected] with the entry link and your evidence. We aim to acknowledge within two working days and decide within seven. If we confirm an error, we aim to correct it within 24 hours of confirming it. These are aims, not guarantees.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Concern

    requests shell access. No manifest field names shell or command execution.

    PERMISSION_SHELL_UNDECLARED

    packages/cli/src/packages.ts, line 15

    * could `child_process.exec('npm i …')` on its own. Putting it behind a second flag would be theatre;

    docs/tools/mcp.md, line 226

    This is not a new grant on top of `--scripts`: a script could already `child_process.exec('npm i …')` by itself. What the tools buy is that the dependency is *declared* - in the to

  • Install and update

    Pass

    No install-time script found, and dependencies are pinned or absent.

  • Network

    Concern

    can reach a host that is not written as a fixed address. can reach registry.npmjs.org. The description does not name that host. can reach elsewhere. The description does not name that host.

    NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST

    packages/cli/src/basePath.test.ts, line 62

    const page = await fetch(`${origin}${BASE}/`)

    packages/cli/src/basePath.test.ts, line 67

    const identity = await fetch(`${origin}${BASE}/console.json`)

    packages/cli/src/basePath.test.ts, line 71

    const handshake = await fetch(`${origin}${BASE}/socket.io/?EIO=4&transport=polling`)

    Show more

    packages/cli/src/basePath.test.ts, line 82

    const response = await fetch(`${origin}${BASE}`, { redirect: 'manual' })

    packages/cli/src/basePath.test.ts, line 95

    t.is((await fetch(`${origin}${path}`)).status, 404, path)

    packages/cli/src/basePath.test.ts, line 129

    t.is((await fetch(`${origin}/`)).status, 200)

    packages/cli/src/basePath.test.ts, line 130

    t.is((await fetch(`${origin}/console.json`)).status, 200)

    packages/cli/src/basePath.test.ts, line 131

    t.is((await fetch(`${origin}/socket.io/?EIO=4&transport=polling`)).status, 200)

    packages/cli/src/mcp.test.ts, line 937

    fetch(`http://127.0.0.1:${port}/mcp`, {

    packages/cli/src/mcp.test.ts, line 975

    const got = await fetch('http://127.0.0.1:8675/mcp')

    packages/cli/src/tasks.test.ts, line 275

    t.is((await fetch('http://127.0.0.1:7591')).status, 200)

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    packages/cli/src/index.ts, line 444

    const environmentTokens = process.env.SOURCE_RPC_TOKENS

    packages/cli/src/index.ts, line 455

    ...(process.env.SOURCE_RPC_TOKEN ? { token: process.env.SOURCE_RPC_TOKEN } : {}),

    packages/cli/src/index.ts, line 984

    let doorToken = process.env.SOURCE_RPC_MCP_TOKEN || undefined

    Show more

    packages/cli/src/network.ts, line 87

    ...(hasEnvironmentValue('SOURCE_RPC_MQTT_PASSWORD') ? { password: process.env.SOURCE_RPC_MQTT_PASSWORD } : {})

    packages/cli/src/scripting.test.ts, line 466

    "const peer = new RpcServer({ name: process.env.SOURCE_RPC_NAME, transports: [{ connect: process.env.SOURCE_RPC_HUB, credentials: { token: process.env.SOURCE_RPC_TOKEN } }] })",

    packages/cli/src/scripts.test.ts, line 93

    saveScript(dir, 'whoami', 'console.log(`${process.env.SOURCE_RPC_NAME} ${process.env.SOURCE_RPC_TOKEN}`)', 'mjs')

    packages/cli/src/scripts.test.ts, line 116

    saveScript(dir, 'bare', 'console.log(`name=${process.env.SOURCE_RPC_NAME ?? "none"} token=${process.env.SOURCE_RPC_TOKEN ?? "none"}`)', 'mjs')

    .vscode/launch.json, line 76

    "envFile": "${workspaceRoot}/.env",

    README.md, line 143

    echo "CONSOLE_TOKEN=$(openssl rand -hex 32)" > docker-compose/.env

    docker-compose/network.yml, line 15

    # echo "CONSOLE_TOKEN=$(openssl rand -hex 32)" > docker-compose/.env

    docs/deploying-a-network.md, line 25

    echo "CONSOLE_TOKEN=$(openssl rand -hex 32)" > docker-compose/.env

    docs/tools/cli.md, line 547

    echo "CONSOLE_TOKEN=$(openssl rand -hex 32)" > docker-compose/.env

    packages/cli/src/mcp.test.ts, line 219

    env: { ...process.env, ...env }

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Concern

    contains an encoded blob in a file that should be readable.

    OBFUSCATION_ENCODED_BLOB

    CHANGELOG.md, line 1

    # Changelog

    package-lock.json, line 1

    {

    packages/opcua/src/Identity.ts, line 1

    /**

    Show more

    packages/sparkplug/src/generated/sparkplug_b_pb.ts, line 30

    fileDesc("ChFzcGFya3BsdWdfYi5wcm90bxIZb3JnLmVjbGlwc2UudGFodS5wcm90b2J1ZiLuFQoHUGF5bG9hZBIRCgl0aW1lc3RhbXAYASABKAQSOgoHbWV0cmljcxgCIAMoCzIpLm9yZy5lY2xpcHNlLnRhaHUucHJvdG9idWYuUGF5bG

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Get the full report on this tool, £49

Note

Hygiene check of commit 5878611d031f. requests shell access. No manifest field names shell or command execution. can reach a host that is not written as a fixed address. can reach registry.npmjs.org. The description does not name that host. can reach elsewhere. The description does not name that host. reads a credential or environment file. contains an encoded blob in a file that should be readable.

Date and source

Date checked:

View source

github.com

Commit graded: 5878611d031f13dfe1d2841993202e1c18bc4d9b

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen