MCP Server MCP

io.github.vukvukovich/hammerspoon-mcp

By github 👁 1 views ▲ 0 votes

Control macOS through Hammerspoon: windows, apps, and API search. Injection-safe by design.

Homepage Verified source GitHub

Install

npx -y @vukvukovich/[email protected]

Configuration Example

{
  "remotes": [],
  "packages": [
    {
      "registryType": "npm",
      "identifier": "@vukvukovich/hammerspoon-mcp",
      "version": "0.4.0",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Which tools to expose. \"safe\" (default) exposes inspection, window management, and system tools only. \"all\" additionally exposes hs_eval, hs_applescript, and hs_ui_press, which run arbitrary Lua and AppleScript and press UI elements - anything the user can do.",
          "default": "safe",
          "name": "HS_MCP_TOOLS"
        },
        {
          "description": "How Lua reaches Hammerspoon. \"socket\" (default) keeps one persistent Unix domain socket, self-installed on first call, with automatic fallback to spawning; \"spawn\" runs one hs process per call.",
          "default": "socket",
          "name": "HS_MCP_TRANSPORT"
        },
        {
          "description": "Explicit path to the Hammerspoon hs command line tool. Only needed when Hammerspoon is installed somewhere unusual.",
          "name": "HS_MCP_HS_PATH"
        },
        {
          "description": "Explicit path to Hammerspoon's bundled docs.json, used by hs_api_search.",
          "name": "HS_MCP_DOCS_PATH"
        },
        {
          "description": "Log verbosity on stderr: debug, info (default), warn, or error.",
          "default": "info",
          "name": "HS_MCP_LOG_LEVEL"
        }
      ]
    }
  ]
}

mcp model-context-protocol npm