Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Template Mcp Server

A production-ready template for developing Model Context Protocol (MCP) servers using Python and FastMCP.

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

NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV INSTALL_DOCUMENTED_INSTALLER SECRETS_ENV_READ

Why this grade

  • NETWORK_NO_FIXED_HOST Low

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

    examples/fastmcp_client.py, line 38 response = requests.get(self.health_endpoint, timeout=10)

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    template_mcp_server/src/settings.py, line 20 logger.warning(f"Could not load .env file: {e}")

  • INSTALL_DOCUMENTED_INSTALLER Note

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

    docs/development.md, line 16 curl -LsSf https://astral.sh/uv/install.sh | sh

  • SECRETS_ENV_READ Note

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

    examples/langgraph_client.py, line 53 gemini_api_key = os.getenv("GEMINI_API_KEY")

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 execution found, and no extra permission was declared.

  • Install and update

    Note

    The docs document an installer that pipes a download into a shell.

    INSTALL_DOCUMENTED_INSTALLER

    docs/development.md, line 16

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

  • Network

    Concern

    can reach a host that is not written as a fixed address.

    NETWORK_NO_FIXED_HOST

    examples/fastmcp_client.py, line 38

    response = requests.get(self.health_endpoint, timeout=10)

    template_mcp_server/src/oauth/introspection.py, line 46

    response = httpx.post(

    template_mcp_server/src/oauth/introspection.py, line 113

    response = httpx.get(

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    examples/langgraph_client.py, line 53

    gemini_api_key = os.getenv("GEMINI_API_KEY")

    examples/langgraph_client.py, line 59

    google_creds_path = os.getenv("GOOGLE_APPLICATION_CREDENTIALS")

    template_mcp_server/src/settings.py, line 20

    logger.warning(f"Could not load .env file: {e}")

    Show more

    .containerignore, line 34

    # Environment files (use .env.template instead)

    .devcontainer/devcontainer.json, line 4

    "postCreateCommand": "pip install uv && uv venv && . .venv/bin/activate && uv pip install -e '.[dev]' && pre-commit install && cp -n .env.example .env 2>/dev/null || true",

    .gitignore, line 32

    # Environments

    Makefile, line 78

    @test -f .env || (echo "Creating .env from .env.example..." && cp .env.example .env)

    README.md, line 50

    cp .env.example .env

    README.md, line 90

    | `.env.example` | Adjust defaults if your server uses a different port or protocol |

    README.md, line 115

    *\* `ENABLE_AUTH` defaults to `False` in `.env.example` but `True` in code. Always copy `.env.example` to `.env` to start with auth disabled.*

  • 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 286b9e7b732a. The docs document an installer that pipes a download into a shell. 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: 286b9e7b732af9d58f9dfd9be68c071e55919ea4

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