Grades are a hygiene check, not a security guarantee.

MCP, MCP server

OpenCode MCP Bridge

opencode-mcp-bridge A coordinator-facing MCP server for a self-hosted OpenCode instance.

Compatibility: Not stated.

Grade B

Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.

Graded by PlugVetRubric v2

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

Rescanned at commit 3ed21545885c, unchanged since the check below.

NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP

Why this grade

  • NETWORK_NO_FIXED_HOST Low

    Makes a network call whose host is not written as a fixed address.

    scripts/live_conformance.sh, line 62 need_cmd curl || exit 1

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    src/opencode_mcp_bridge/config.py, line 3 Reads settings from the environment (or a .env file when present).

  • SECRETS_ENV_READ Note

    Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.

    scripts/live_conformance.sh, line 162 token = os.environ.get("OPENCODE_MCP_LIVE_REDACT_TOKEN", "")

  • OBFUSCATION_FILE_OVER_READ_CAP Note

    A file was over the read cap and was not fully read.

    uv.lock, line 1 version = 1

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.

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

    Pass

    No shell or command call was found in the code. This check does not read permissions an entry declares. A permission line to write or edit files was found in this repository, and it may apply to this entry.

  • 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.

    NETWORK_NO_FIXED_HOST

    scripts/live_conformance.sh, line 62

    need_cmd curl || exit 1

    scripts/live_conformance.sh, line 116

    HEALTH_CODE=$(curl -sS -o /dev/null -w "%{http_code}" --max-time 15 "$HEALTH_URL") || fail "health request failed"

    scripts/live_conformance.sh, line 134

    # Bearer token never appears in the process list: curl reads it from a

    Show more

    scripts/live_conformance.sh, line 142

    curl -sS --max-time 20 -X POST "$_url" \

    scripts/smoke.sh, line 45

    need_cmd curl || exit 1

    scripts/smoke.sh, line 79

    HEALTH_CODE=$(curl -sS -o /dev/null -w "%{http_code}" --max-time 15 "$HEALTH_URL") || fail "health request failed"

    scripts/smoke.sh, line 84

    UNAUTH_CODE=$(curl -sS -o /dev/null -w "%{http_code}" --max-time 15 -X POST "$MCP_URL" \

    scripts/smoke.sh, line 106

    curl -sS -o "$STREAM_FIFO" -w "%{http_code}" --max-time 20 -X POST "$MCP_URL" \

    Dockerfile, line 35

    CMD python -c "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8087/health', timeout=4)"

    docker-compose.yml, line 34

    test: ["CMD", "/app/.venv/bin/python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8087/health', timeout=4)"]

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    scripts/live_conformance.sh, line 162

    token = os.environ.get("OPENCODE_MCP_LIVE_REDACT_TOKEN", "")

    src/opencode_mcp_bridge/config.py, line 3

    Reads settings from the environment (or a .env file when present).

    src/opencode_mcp_bridge/config.py, line 22

    path = dotenv_path or Path.cwd() / ".env"

    Show more

    src/opencode_mcp_bridge/config.py, line 347

    """Load settings from environment, optionally reading a .env file first.

    src/opencode_mcp_bridge/config.py, line 350

    dotenv_path: Explicit path to a .env file. Defaults to ./.env when present.

    .env.example, line 1

    # Copy to .env and fill in. Never commit .env.

    .env.example, line 13

    # restart. Blank or duplicate values fail startup closed. Never commit .env.

    .gitignore, line 7

    # Env

    AGENTS.md, line 21

    - Never commit `.env`, tokens, or passwords. `.env.example` documents config; `.env` stays local.

  • Agent instructions

    Pass

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

  • Obfuscation

    Note

    a file was over the read cap and was not fully read.

    OBFUSCATION_FILE_OVER_READ_CAP

    uv.lock, line 1

    version = 1

  • Licence

    Pass

    A licence file is present (LICENSE.md).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit 3ed21545885c. can reach a host that is not written as a fixed address. reads a credential or environment file. a file was over the read cap and was not fully read.

Date and source

Date checked:

View source

github.com

Commit graded: 3ed21545885c1f76ec3cca1de415f7a2e266e9e2

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