Grades are a hygiene check, not a security guarantee.

MCP, MCP server

omop_mcp

Model Context Protocol (MCP) server for mapping clinical terminology to Observational Medical Outcomes Partnership (OMOP) concepts using Large Language Models (LLMs).

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.

NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP

Why this grade

  • NETWORK_NO_FIXED_HOST Low

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

    scripts/test_omophub_apis.py, line 45 r = requests.get(f"{OMOPHUB_BASE_URL}/search/concepts", headers=HEADERS, params={"query": query, "page_size": page_size}, timeout=10)

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    scripts/test_omophub_apis.py, line 13 env_path = Path(__file__).parent.parent / ".env"

  • SECRETS_ENV_READ Note

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

    scripts/test_omophub_apis.py, line 16 OMOPHUB_API_KEY = os.getenv("OMOPHUB_API_KEY")

  • 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

    Pass

    No shell or command execution found, and no extra permission was declared.

  • 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/test_omophub_apis.py, line 45

    r = requests.get(f"{OMOPHUB_BASE_URL}/search/concepts", headers=HEADERS, params={"query": query, "page_size": page_size}, timeout=10)

    scripts/test_omophub_apis.py, line 51

    r = requests.get(f"{OMOPHUB_BASE_URL}/concepts/{concept_id}", headers=HEADERS, timeout=10)

    scripts/test_omophub_apis.py, line 57

    r = requests.get(f"{OMOPHUB_BASE_URL}/domains", headers=HEADERS, timeout=10)

    Show more

    scripts/test_omophub_apis.py, line 63

    r = requests.get(f"{OMOPHUB_BASE_URL}/vocabularies", headers=HEADERS, timeout=10)

    scripts/test_omophub_apis.py, line 69

    r = requests.post(f"{OMOPHUB_BASE_URL}/search/bulk", headers=HEADERS, json={"queries": queries}, timeout=10)

    scripts/test_omophub_apis.py, line 75

    r = requests.get(f"{OMOPHUB_BASE_URL}/concepts/{concept_id}/relationships", headers=HEADERS, timeout=10)

    scripts/test_omophub_apis.py, line 90

    r = requests.get(f"{OMOPHUB_BASE_URL}/search/concepts", headers=HEADERS, params={"query": "diabetes", "page_size": 1}, timeout=10)

    src/omop_mcp/utils.py, line 287

    response = httpx.get(

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    scripts/test_omophub_apis.py, line 13

    env_path = Path(__file__).parent.parent / ".env"

    scripts/test_omophub_apis.py, line 16

    OMOPHUB_API_KEY = os.getenv("OMOPHUB_API_KEY")

    scripts/test_omophub_apis.py, line 20

    raise ValueError("OMOPHUB_API_KEY not found in .env file")

    Show more

    src/omop_mcp/utils.py, line 36

    api_key = os.getenv("OMOPHUB_API_KEY", "")

    src/omop_mcp/utils.py, line 91

    api_key=api_key or os.getenv("AZURE_OPENAI_API_KEY", ""),

    src/omop_mcp/utils.py, line 103

    api_key=api_key or os.getenv("OPENAI_API_KEY", ""),

    src/omop_mcp/utils.py, line 114

    api_key=api_key or os.getenv("ANTHROPIC_API_KEY", ""),

    src/omop_mcp/utils.py, line 125

    api_key=api_key or os.getenv("GOOGLE_API_KEY", ""),

    src/omop_mcp/utils.py, line 172

    api_key=api_key or os.getenv("OPENROUTER_API_KEY", ""),

    src/omop_mcp/utils.py, line 186

    api_key=api_key or os.getenv("GROQ_API_KEY", ""),

    .env.template, line 1

    # Change this file to .env and fill in your actual credentials

    .gitignore, line 15

    .DS_Store

    README.md, line 31

    Copy `.env.template` to `.env` and fill in your API credentials. You will need both an LLM provider key and an **[OMOPHUB_API_KEY](https://omophub.com)** (for vocabulary lookups).

    README.md, line 34

    cp .env.template .env

  • 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

    reference/omop_cdm_v5_4_dictionary.csv, line 1

    table_name,table_description,column,type,comments

  • 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 76281557f684. can reach a host that is not written as a fixed address. 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: 76281557f684677e3a5980403c8c4d3b42d7b841

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