MCP, MCP server
io.github.cameronrye/openzim-mcp
io.github.cameronrye/openzim-mcp, an MCP server listed in the PlugVet directory.
Compatibility: Not stated.
Grade C
One Medium finding. Read the report before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
NETWORK_HOST_FROM_INPUT
Why this grade
- NETWORK_HOST_FROM_INPUT Medium
A file takes a URL or endpoint as input and has no fixed host list.
openzim_mcp/content_processor.py, line 2403
# Entry-content fetch (get_zim_entry / get_entries): scope
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
openzim_mcp/linkgraph/builder.py, line 62
os.remove(tmp_path)
scripts/build_mcpb.py, line 90
proc = subprocess.Popen( # nosec B603 - sys.executable + fixed module
scripts/build_mcpb.py, line 122
def _handshake_list_tools(proc: subprocess.Popen, timeout_s: int) -> list[dict]:
Show more
scripts/check_tools.py, line 20
result = subprocess.run( # nosec B603 - safe, hardcoded commands only
scripts/check_tools.py, line 34
result = subprocess.run( # nosec B603 - safe, sys.executable only
scripts/clean.py, line 22
shutil.rmtree(path)
scripts/clean_test_data.py, line 26
shutil.rmtree(test_data_dir)
scripts/generate_help.py, line 19
os.system("") # nosec B605,B607 - empty string to enable ANSI on Windows
scripts/run_server.py, line 38
result = subprocess.run( # nosec B603,B607 - safe, dev tooling use
scripts/run_with_env.py, line 40
result = subprocess.run( # NOSONAR pythonsecurity:S8705 (B603: no shell)
scripts/setup_dev_env.py, line 25
subprocess.run( # nosec B602 - intentional use for dev tooling
Install and update
Note
The docs document an installer that pipes a download into a shell.
INSTALL_DOCUMENTED_INSTALLER
website/src/content/docs/installation.mdx, line 29
curl -LsSf https://astral.sh/uv/install.sh | sh
website/src/content/docs/installation.mdx, line 58
curl -LsSf https://astral.sh/uv/install.sh | sh
website/src/content/docs/installation.mdx, line 199
curl -LsSf https://astral.sh/uv/install.sh | sh
Show more
website/src/content/docs/installation.mdx, line 229
curl -LsSf https://astral.sh/uv/install.sh | sh
website/src/content/docs/installation.mdx, line 258
curl -LsSf https://astral.sh/uv/install.sh | sh
website/src/content/docs/troubleshooting.mdx, line 118
1. **Install uv**: `curl -LsSf https://astral.sh/uv/install.sh | sh`
Network
Serious
accepts a host from input, with no fixed list in this file.
NETWORK_HOST_FROM_INPUT
openzim_mcp/content_processor.py, line 2403
# Entry-content fetch (get_zim_entry / get_entries): scope
openzim_mcp/http_app.py, line 516
can ``fetch()`` the endpoint in a loop; every request is rejected and every
openzim_mcp/onboarding.py, line 61
#: The ``mkdir -p`` is not decoration: ``curl -o`` into a directory that
Show more
openzim_mcp/onboarding.py, line 69
f"curl -fsSL -o {STARTER_ARCHIVE_DIR}/{STARTER_ARCHIVE_FILENAME} "
openzim_mcp/tools/zim_get.py, line 204
f"fetch (provided: {max_content_length:,}); a larger "
scripts/check_docs_links.py, line 133
# on was the one URL CI never probed. ``curl -fsSL`` writes nothing and prints
scripts/check_docs_links.py, line 393
with urllib.request.urlopen(req, timeout=timeout) as resp: # noqa: S310
CHANGELOG.md, line 607
- `zim_get_section` - section-level fetch (renamed from
website/src/content/docs/http-and-docker-deployment.mdx, line 406
- "import urllib.request,sys; sys.exit(0 if urllib.request.urlopen('http://localhost:8000/readyz').getcode()==200 else 1)"
Secrets
Concern
reads a credential or environment file.
SECRETS_PATH_DOTENV
.gitignore, line 14
.venv
website/src/content/docs/http-and-docker-deployment.mdx, line 423
- **Token via env, not hard-coded.** Put it in a `.env` file next to the compose file (and add `.env` to `.gitignore`). The image defaults to `stdio`, so `TRANSPORT=http` and `HOST
website/src/content/docs/http-and-docker-deployment.mdx, line 431
echo "OPENZIM_MCP_AUTH_TOKEN=$(openssl rand -hex 32)" > .env
Show more
website/src/content/docs/http-and-docker-deployment.mdx, line 448
TOKEN=$(grep OPENZIM_MCP_AUTH_TOKEN .env | cut -d= -f2)
website/src/content/docs/http-and-docker-deployment.mdx, line 581
echo "OPENZIM_MCP_AUTH_TOKEN=$(openssl rand -hex 32)" > .env
website/src/content/docs/http-and-docker-deployment.mdx, line 597
TOKEN=$(grep OPENZIM_MCP_AUTH_TOKEN .env | cut -d= -f2)
website/src/content/docs/http-and-docker-deployment.mdx, line 610
- **Token rotation.** Generate a new token, update `.env`, run `docker compose up -d` to pick up the change. Distribute the new token to clients out-of-band.
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. the file cap was reached before every file was read.
OBFUSCATION_FILE_OVER_READ_CAP OBFUSCATION_FILE_CAP_REACHED
CHANGELOG.md, line 1
# Changelog
uv.lock, line 1
version = 1
openzim_mcp/simple_tools.py, line 1
"""Simple tools implementation for OpenZIM MCP server.
Show more
openzim_mcp/zim/search.py, line 1
"""Search-related methods for ``ZimOperations``.
tests/test_simple_tools.py, line 1
"""Tests for simple tools functionality."""
tests/test_walk_namespace.py, line 1
"""Tests for walk_namespace tool."""
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 9358db06f205. can delete files. The docs document an installer that pipes a download into a shell. accepts a host from input, with no fixed list in this file. reads a credential or environment file. a file was over the read cap and was not fully read. the file cap was reached before every file was read.
Date and source
Date checked:
github.com
Commit graded: 9358db06f205bb0b95cc938c68405851a0e205a8
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.