io.github.cameronrye/openzim-mcp

What we checked

Six static checks, weighted by risk. Every result reflects only what could be observed in the published package and repository — never intent.

• Injection surface

  unscannable25% of grade

  Tool descriptions/manifest scanned for instruction-injection patterns (imperatives at the model, hidden text, 'ignore previous', data-exfil URLs).

  No tool descriptions, server instructions, prompts, or resources were fetched; nothing to scan for injection.

• Supply chain

  pass25% of grade

  Package provenance: namespace verification, repo linkage, maintainer count, account age, postinstall scripts, typosquat distance.

  Python build script has no build-time network/exec; repository linkage verified

• Credential hygiene

  warn15% of grade

  How the server takes secrets (env vs plaintext config vs hardcoded); secrets appearing in tool schemas.

  tests/test_cursor_decode.py: assigns a literal to token (!!!n…!! (len 16)) — non-provider secret literal; prefer environment intake. Reads secrets from the environment (e.g. openzim_mcp/ml/reranker.py) — the recommended intake shape.

• Permission scope

  warn15% of grade

  Declared tools vs. breadth (filesystem, network, exec); flags shell-exec and unbounded filesystem access.

  discloses dynamic code execution: tests/test_main.py: uses eval/exec/__import__ discloses dynamic code execution: tests/test_typo_variants_v2a7.py: uses eval/exec/__import__ discloses dynamic code execution: tests/test_v2a7_fixes_helpers.py: uses eval/exec/__import__ discloses broad/destructive filesystem access: openzim_mcp/article_body.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: openzim_mcp/content_processor.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: openzim_mcp/error_messages.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: openzim_mcp/linkgraph/builder.py: destructive filesystem call (shutil.rmtree/os.remove/etc.) discloses broad/destructive filesystem access: openzim_mcp/server_state.py: recursive glob ('**') from a broad root discloses broad/destructive filesystem access: openzim_mcp/simple_tools.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: openzim_mcp/subscriptions.py: recursive glob ('**') from a broad root discloses broad/destructive filesystem access: openzim_mcp/zim/archive.py: recursive glob ('**') from a broad root discloses broad/destructive filesystem access: openzim_mcp/zim/content.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: openzim_mcp/zim/structure.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_beta_sweep_chrome_fixes.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_cache.py: open(…, 'w'/'a'/'x') write-mode file access discloses broad/destructive filesystem access: tests/test_get_related_articles.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_namespace_scheme_aware.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_path_error_wording.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_path_traversal_d12_v2a9.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_post_a21_beta_fixes.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_post_a22_beta_fixes.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_post_b11_beta_fixes.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_post_b1_beta_fixes.py: destructive filesystem call (shutil.rmtree/os.remove/etc.) discloses broad/destructive filesystem access: tests/test_post_v2_1_0_beta_fixes.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_regex_security.py: open(…, 'w'/'a'/'x') write-mode file access discloses broad/destructive filesystem access: tests/test_security.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_server.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_simple_tools.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_synthesize_section_attribution_live_shape.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_truncate_content_messaging.py: path traversal ('../') combined with file access discloses broad/destructive filesystem access: tests/test_zim_operations.py: recursive glob ('**') from a broad root Capability DISCLOSURE, not a verdict: static analysis sees the primitive is present and reachable, not whether its use is attacker-controlled.

• Version behavior

  unscannable10% of grade

  Diff of tool definitions between versions; new permissions or changed descriptions in a patch release (the postmark-mcp class).

  no prior version to diff (first sight of io.github.cameronrye/[email protected]); version-drift / rug-pull cannot be evaluated. Cold-start risk is covered by point-in-time checks (injection_surface, supply_chain, credential_hygiene), not here.

• Transport config

  warn10% of grade

  Remote servers: TLS and auth mode (none/token/OAuth). Local servers: whether the manifest indicates it phones home.

  manifest/source references telemetry behavior — disclosure