io.github.vukvukovich/hammerspoon-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

  warn25% of grade

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

  tool "hs_open_url" param "url" description: off-vendor URL in a description (.); capability text should not name where data goes.

• Supply chain

  warn25% of grade

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

  dependency "@modelcontextprotocol/server" is edit-distance 1 from popular package "semver" (typosquat candidate)

• Credential hygiene

  pass15% of grade

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

  No hardcoded secrets, secret-shaped tool parameters, or leaked keys found. PASS = no static red flag; static analysis cannot prove the code honors env-based secret handling at runtime.

• Permission scope

  pass15% of grade

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

  No shell-exec, unbounded/sensitive filesystem, or download-and-run primitives found in scanned source. PASS = no static red flag. Static scanning is blind to code fetched or executed at runtime.

• Version behavior

  warn10% of grade

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

  vs prior 0.1.1 (minor bump): new tool "hs_health" appeared; new tool "hs_api_search" appeared; new tool "hs_list_windows" appeared; new tool "hs_focus_window" appeared; new tool "hs_move_window" touches a sensitive surface (email/exec/net/fs); new tool "hs_window_layout" appeared; new tool "hs_list_apps" appeared; new tool "hs_launch_app" appeared; new tool "hs_focus_app" appeared; new tool "hs_screens" appeared; new tool "hs_list_spaces" appeared; new tool "hs_goto_space" appeared; new tool "hs_audio_devices" appeared; new tool "hs_audio_set_device" appeared; new tool "hs_audio_volume" touches a sensitive surface (email/exec/net/fs); new tool "hs_brightness" touches a sensitive surface (email/exec/net/fs); new tool "hs_media_control" touches a sensitive surface (email/exec/net/fs); new tool "hs_machine_status" appeared; new tool "hs_peripherals" appeared; new tool "hs_wifi" appeared; new tool "hs_notification" appeared; new tool "hs_keep_awake" touches a sensitive surface (email/exec/net/fs); new tool "hs_lock_screen" appeared; new tool "hs_list_shortcuts" appeared; new tool "hs_run_shortcut" touches a sensitive surface (email/exec/net/fs); new tool "hs_ui_inspect" touches a sensitive surface (email/exec/net/fs); new tool "hs_open_url" touches a sensitive surface (email/exec/net/fs); new tool "hs_default_browser" touches a sensitive surface (email/exec/net/fs); new tool "hs_music_status" appeared; new tool "hs_music_control" touches a sensitive surface (email/exec/net/fs); new tool "hs_speak" appeared; new tool "hs_list_voices" appeared; new tool "hs_network" appeared; new tool "hs_caps_lock" touches a sensitive surface (email/exec/net/fs); new tool "hs_settings" touches a sensitive surface (email/exec/net/fs); new tool "hs_console_tail" appeared; new tool "hs_notify" appeared; new tool "hs_reload_config" appeared.

• Transport config

  unscannable10% of grade

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

  local stdio server: no remote transport or auth surface, and no phone-home/telemetry signal found in source. Absence of transport findings is NOT a safety guarantee — phone-home hosts can be constructed at runtime and defeat static analysis.