Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Compass Mcp

Local MCP that reads what you're doing and suggests which model fits — copy tweak vs UI vs nasty bug, that kind of thing.

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.

PERMISSION_DELETE_FILES NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ

Why this grade

  • PERMISSION_DELETE_FILES Low

    Contains a call that can delete files.

    scripts/codexHostSmoke.ts, line 282 fs.rmSync(scratch, { recursive: true, force: true });

  • NETWORK_NO_FIXED_HOST Low

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

    scripts/httpLimitsSmoke.ts, line 22 return fetch(url, { method: "POST", headers: headers(), body: JSON.stringify(body), signal: AbortSignal.timeout(5000) });

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    scripts/connectLib.ts, line 98 /** Remove an existing [mcp_servers.<name>] block (and nested .env table). */

  • SECRETS_ENV_READ Note

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

    src/httpConfig.ts, line 39 const apiKey = process.env.COMPASS_MCP_API_KEY?.trim() || undefined;

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

    Concern

    can delete files.

    PERMISSION_DELETE_FILES

    scripts/codexHostSmoke.ts, line 282

    fs.rmSync(scratch, { recursive: true, force: true });

    scripts/connectSmoke.ts, line 26

    fs.rmSync(dir, { recursive: true, force: true });

    scripts/expensiveGateSmoke.ts, line 345

    fs.rmSync(tmp, { recursive: true, force: true });

    Show more

    scripts/smoke.ts, line 795

    fs.rmSync(tmpDir, { recursive: true, force: true });

    src/sticky.ts, line 69

    fs.unlinkSync(filePath);

  • 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/httpLimitsSmoke.ts, line 22

    return fetch(url, { method: "POST", headers: headers(), body: JSON.stringify(body), signal: AbortSignal.timeout(5000) });

    scripts/httpLimitsSmoke.ts, line 63

    const closed = await fetch(url, { method: "DELETE", headers: headers(), signal: AbortSignal.timeout(5000) });

    scripts/remote-install.sh, line 5

    # curl -fsSL https://raw.githubusercontent.com/JakeLim17/compass-mcp/main/scripts/remote-install.sh \

    Show more

    scripts/smokeHttp.ts, line 49

    const res = await fetch(`${BASE}/health`);

    scripts/smokeHttp.ts, line 109

    const health = await fetch(`${BASE}/health`);

    scripts/smokeHttp.ts, line 126

    const initRes = await fetch(`${BASE}/mcp`, {

    scripts/smokeHttp.ts, line 152

    const toolsRes = await fetch(`${BASE}/mcp`, {

    scripts/smokeHttp.ts, line 182

    const noKey = await fetch(`${BASE}/health`, {

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    scripts/codexHostSmoke.ts, line 36

    assert.deepEqual(buildMcpServerConfig("/example/repo", "codex").env, { COMPASS_MCP_HOST: "codex" });

    scripts/connectLib.ts, line 98

    /** Remove an existing [mcp_servers.<name>] block (and nested .env table). */

    src/httpConfig.ts, line 39

    const apiKey = process.env.COMPASS_MCP_API_KEY?.trim() || undefined;

    Show more

    scripts/connectLib.ts, line 120

    [mcp_servers.${SERVER_NAME}.env]

    scripts/connectSmoke.ts, line 49

    assert(parsed.mcpServers[SERVER_NAME]?.env?.COMPASS_MCP_HOST === "cursor", "cursor host env");

    src/httpConfig.ts, line 42

    process.env.COMPASS_MCP_ALLOW_REMOTE_NO_KEY === "true";

    .gitignore, line 2

    dist/

    .gitignore, line 3

    .env

  • 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 b6246ae053f9. can delete files. 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: b6246ae053f9073ef214b9415db078864e71e6c9

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