Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Charles Mcp

Docs | Tool Contract | AGENTS | Agent Workflow Guide | English README

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 eb5d0927739a, unchanged since the check below.

PERMISSION_DELETE_FILES INSTALL_UNPINNED SECRETS_PATH_DOTENV INSTALL_DOCUMENTED_INSTALLER OBFUSCATION_FILE_OVER_READ_CAP

Why this grade

  • PERMISSION_DELETE_FILES Low

    Contains a call that can delete files.

    charles_mcp/utils.py, line 177 shutil.rmtree(dst)

  • INSTALL_UNPINNED Low

    Dependencies use a range or git URL with no lockfile.

    README.en.md, line 115 - macOS/Linux: run: curl -LsSf https://astral.sh/uv/install.sh | sh

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    .env.example, line 2 # Copy this file to .env and adjust values for your local environment.

  • INSTALL_DOCUMENTED_INSTALLER Note

    Documentation shows an installer that pipes a download into a shell.

    README.en.md, line 115 - macOS/Linux: run: curl -LsSf https://astral.sh/uv/install.sh | sh

  • 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

    Concern

    can delete files.

    PERMISSION_DELETE_FILES

    charles_mcp/utils.py, line 177

    shutil.rmtree(dst)

    charles_mcp/utils.py, line 203

    shutil.rmtree(path)

    charles_mcp/reverse/ingest/native_convert.py, line 23

    result = subprocess.run(

  • Install and update

    Concern

    dependencies are not pinned. README documents an installer that pipes a download into a shell.

    INSTALL_UNPINNED INSTALL_DOCUMENTED_INSTALLER

    README.en.md, line 115

    - macOS/Linux: run: curl -LsSf https://astral.sh/uv/install.sh | sh

    README.md, line 115

    - macOS/Linux: run: curl -LsSf https://astral.sh/uv/install.sh | sh

    requirements.txt, line 2

    mcp>=1.25.0

  • Network

    Pass

    No network call found.

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_PATH_DOTENV

    .env.example, line 2

    # Copy this file to .env and adjust values for your local environment.

    .gitignore, line 22

    # Local environment files

    docs/plans/2026-03-06-charles-mcp-stabilization.md, line 332

    - Modify: `.env.example`

    Show more

    docs/plans/2026-03-06-charles-mcp-stabilization.md, line 374

    git add pyproject.toml README.md .env.example .gitignore .github/workflows/ci.yml docs/contracts/tools.md tests/fixtures/session_sample.chlsj

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

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit eb5d0927739a. can delete files. dependencies are not pinned. README documents an installer that pipes a download into a shell. 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: eb5d0927739ab278cc8903e55e40160efee15c45

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