Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Mcp Server Bash Sdk

MCP server SDK/example implemented entirely in bash — build a Model Context Protocol server with no runtime dependency beyond a POSIX shell.

Compatibility: Not stated.

Grade C

One Medium finding. Read the findings 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 059ec6ca45cd, unchanged since the check below.

SECRETS_PATH_CREDENTIAL

Why this grade

  • SECRETS_PATH_CREDENTIAL Medium

    Mentions a credential store path (~/.ssh, id_rsa, .npmrc, .aws/credentials, credentials.json, .netrc).

    examples/fileserver.sh, line 6 # careless line away from "read /etc/passwd" or "read ~/.ssh/id_rsa".

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 run shell commands 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

    test_http_transport.sh, line 29

    http() { # http <curl args...>; sets HTTP_STATUS and HTTP_BODY

    test_http_transport.sh, line 32

    out=$(curl -s -m 5 -w '\n%{http_code}' "$@" 2>/dev/null)

    test_http_transport.sh, line 54

    curl -s -m 1 -o /dev/null "http://127.0.0.1:$PORT/mcp" 2>/dev/null && return 0

    Show more

    test_http_transport.sh, line 270

    command -v curl >/dev/null || { echo -e "${YELLOW}SKIP${NC} HTTP tests: curl not found"; exit 0; }

    docs/spikes/spike-02-http-listener.sh, line 113

    resp=$(curl -s -m 3 -X POST "http://127.0.0.1:$PORT/mcp" \

    docs/spikes/spike-02-http-listener.sh, line 144

    curl -s -m 3 -X POST "http://127.0.0.1:$PORT/mcp" -d '{}' >/dev/null 2>&1 && served=$((served + 1))

    docs/spikes/spike-02-http-listener.sh, line 158

    a=$(curl -s -m 2 -X POST "http://127.0.0.1:$PORT/mcp" -d '{}' 2>/dev/null) &

    docs/spikes/spike-02-http-listener.sh, line 160

    b=$(curl -s -m 2 -X POST "http://127.0.0.1:$PORT/mcp" -d '{}' 2>/dev/null) &

    examples/weatherserver.sh, line 65

    http_status=$(curl -sS -m "$WEATHER_TIMEOUT" -o "$tmp" -w '%{http_code}' \

    examples/weatherserver.sh, line 124

    http_status=$(curl -sS -m "$WEATHER_TIMEOUT" -o "$tmp" -w '%{http_code}' \

    scripts/test-linux.sh, line 115

    "apt-get update -qq && apt-get install -y -qq jq curl git netcat-openbsd" || failed=$((failed + 1))

    scripts/test-linux.sh, line 120

    "apk add --no-cache bash jq curl git netcat-openbsd" || failed=$((failed + 1))

    scripts/test-linux.sh, line 125

    "apt-get update -qq && apt-get install -y -qq jq curl git netcat-openbsd" || failed=$((failed + 1))

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_PATH_CREDENTIAL

    examples/fileserver.sh, line 6

    # careless line away from "read /etc/passwd" or "read ~/.ssh/id_rsa".

    examples/README.md, line 223

    careless line away from reading `~/.ssh/id_rsa`.

  • Agent instructions

    Pass

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

  • Obfuscation

    Pass

    No encoded or minified payload found.

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit 059ec6ca45cd. can reach a host that is not written as a fixed address. reads a credential or environment file.

Date and source

Date checked:

View source

github.com

Commit graded: 059ec6ca45cd11f31cc0cd3a2fa233a0c8743341

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