Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Openapi Mcp Swagger

Stop wrestling with massive API docs in your AI assistant's context window.

Compatibility: Not stated.

Grade D

Two or more Medium findings, or a High finding. 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.

Rescanned at commit e84071385a3d, unchanged since the check below.

PERMISSION_SHELL_UNDECLARED INSTALL_REMOTE_SCRIPT

Why this grade

  • PERMISSION_SHELL_UNDECLARED Medium

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

    src/swagger_mcp_server/conversion/pipeline.py, line 175 shutil.rmtree(output_path)

  • INSTALL_REMOTE_SCRIPT Medium

    Fetches a script from the network and runs it (a pipe to a shell, or an install hook with a URL).

    docs/troubleshooting/COMMON_ISSUES.md, line 26 curl https://pyenv.run | bash

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

    can delete files. requests shell access. No manifest field names shell or command execution.

    PERMISSION_SHELL_UNDECLARED PERMISSION_DELETE_FILES

    src/swagger_mcp_server/conversion/pipeline.py, line 175

    shutil.rmtree(output_path)

    src/swagger_mcp_server/conversion/validator.py, line 212

    result = subprocess.run(

    src/swagger_mcp_server/conversion/validator.py, line 233

    result = subprocess.run(

    Show more

    src/swagger_mcp_server/installation/compatibility.py, line 305

    subprocess.run(

    src/swagger_mcp_server/installation/uninstaller.py, line 146

    shutil.rmtree(self.data_dir)

    src/swagger_mcp_server/installation/uninstaller.py, line 164

    shutil.rmtree(cache_dir)

    src/swagger_mcp_server/installation/uninstaller.py, line 189

    shutil.rmtree(self.backup_dir)

    src/swagger_mcp_server/installation/uninstaller.py, line 206

    shutil.rmtree(self.install_dir)

  • Install and update

    Serious

    install fetches a script from the network.

    INSTALL_REMOTE_SCRIPT

    docs/troubleshooting/COMMON_ISSUES.md, line 26

    curl https://pyenv.run | bash

  • Network

    Concern

    can reach install.python-poetry.org. The description does not name that host. can reach api-performance.ozon.ru. The description does not name that host. can reach a host that is not written as a fixed address. can reach api.example.com. The description does not name that host.

    NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST

    scripts/setup-dev.sh, line 19

    curl -sSL https://install.python-poetry.org | python3 -

    scripts/standalone-mcp.py, line 120

    const response = await fetch('https://api-performance.ozon.ru/api/client/token', {

    scripts/standalone-mcp.py, line 136

    const response = await fetch('https://api-performance.ozon.ru/api/client/campaign', {

    Show more

    scripts/standalone-mcp.py, line 161

    response = requests.post(url, json=payload)

    scripts/standalone-mcp.py, line 172

    response = requests.post(url, json=campaign_data, headers=headers)

    src/swagger_mcp_server/conversion/package_generator.py, line 393

    example += f"curl -X {{endpoint.method}} '{{full_url}}'"

    src/swagger_mcp_server/conversion/package_generator.py, line 413

    example += "fetch(url, {{\\n"

    src/swagger_mcp_server/conversion/package_generator.py, line 419

    example += f"fetch(url, {{{{ method: '{{endpoint.method}}' }}}})\\n"

    src/swagger_mcp_server/conversion/package_generator.py, line 1833

    CMD python -c "import requests; requests.get('http://localhost:{config["port"]}/health')" || exit 1

    src/swagger_mcp_server/conversion/package_generator.py, line 1860

    test: ["CMD", "python", "-c", "import requests; requests.get('http://localhost:{config["port"]}/health')"]

    docs/guides/QUICKSTART.md, line 247

    response = requests.post('http://localhost:8080', json={

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    src/swagger_mcp_server/config/settings.py, line 156

    env_file = ".env"

    src/swagger_mcp_server/conversion/package_generator.py, line 1192

    api_key = os.getenv('API_KEY')

    src/swagger_mcp_server/conversion/package_generator.py, line 1921

    # Copy this file to .env and customize as needed

    Show more

    src/swagger_mcp_server/conversion/package_generator.py, line 1943

    env_path = os.path.join(self.output_dir, ".env.example")

    src/swagger_mcp_server/conversion/package_generator.py, line 1952

    .env

    src/swagger_mcp_server/conversion/validator.py, line 74

    ".env.example",

    .claude/commands/BMad/tasks/document-project.md, line 129

    - **Configuration**: `config/app.config.js`, `.env.example`

    .claude/commands/BMad/tasks/document-project.md, line 237

    3. Required environment variables (see `.env.example`)

    .gitignore, line 40

    # Virtual environments

  • 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

    coverage.xml, line 1

    <?xml version="1.0" ?>

    poetry.lock, line 1

    # This file is automatically @generated by Poetry 2.2.1 and should not be changed by hand.

    uv.lock, line 1

    version = 1

    Show more

    data/swagger_mcp.db-wal, line 1

    7�-�)��M

  • Licence

    Note

    no licence file found.

    LICENCE_MISSING

    No file path was stored.

    no licence file found.

  • Maintainer activity

    Note

    the latest commit is more than 365 days old.

    MAINTAINER_STALE

    No file path was stored.

    2025-10-02T03:34:15+03:00

Get the full report on this tool, £49

Note

Hygiene check of commit e84071385a3d. can delete files. requests shell access. No manifest field names shell or command execution. install fetches a script from the network. can reach install.python-poetry.org. The description does not name that host. can reach api-performance.ozon.ru. The description does not name that host. can reach a host that is not written as a fixed address. can reach api.example.com. The description does not name that host. reads a credential or environment file. a file was over the read cap and was not fully read. no licence file found. the latest commit is more than 365 days old.

Date and source

Date checked:

View source

github.com

Commit graded: e84071385a3d7db7534cbdd4aa1ce389f04f1386

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