Search / io.github.vukvukovich/hammerspoon-mcp
protogridL0· runs locallyControl macOS through Hammerspoon: windows, apps, and API search. Injection-safe by design.
v0.4.0 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"hammerspoon-mcp": {
"command": "npx",
"args": [
"-y",
"@vukvukovich/[email protected]"
],
"env": {
"HS_MCP_TOOLS": "safe",
"HS_MCP_TRANSPORT": "socket",
"HS_MCP_LOG_LEVEL": "info"
}
}
}
}claude mcp add hammerspoon-mcp -e "HS_MCP_TOOLS=safe" -e "HS_MCP_TRANSPORT=socket" -e "HS_MCP_LOG_LEVEL=info" -- npx -y @vukvukovich/[email protected][mcp_servers.hammerspoon-mcp]
command = "npx"
args = ["-y", "@vukvukovich/[email protected]"]
env = { "HS_MCP_TOOLS" = "safe", "HS_MCP_TRANSPORT" = "socket", "HS_MCP_LOG_LEVEL" = "info" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"hammerspoon-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@vukvukovich/[email protected]"
],
"enabled": true,
"environment": {
"HS_MCP_TOOLS": "safe",
"HS_MCP_TRANSPORT": "socket",
"HS_MCP_LOG_LEVEL": "info"
}
}
}
}{
"mcpServers": {
"hammerspoon-mcp": {
"command": "npx",
"args": [
"-y",
"@vukvukovich/[email protected]"
],
"env": {
"HS_MCP_TOOLS": "safe",
"HS_MCP_TRANSPORT": "socket",
"HS_MCP_LOG_LEVEL": "info"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=hammerspoon-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB2dWt2dWtvdmljaC9oYW1tZXJzcG9vbi1tY3BAMC40LjAiXSwiZW52Ijp7IkhTX01DUF9UT09MUyI6InNhZmUiLCJIU19NQ1BfVFJBTlNQT1JUIjoic29ja2V0IiwiSFNfTUNQX0xPR19MRVZFTCI6ImluZm8ifX0%3D"
}{
"servers": {
"hammerspoon-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vukvukovich/[email protected]"
],
"env": {
"HS_MCP_TOOLS": "safe",
"HS_MCP_TRANSPORT": "socket",
"HS_MCP_LOG_LEVEL": "info"
}
}
}
}{
"mcpServers": {
"hammerspoon-mcp": {
"command": "npx",
"args": [
"-y",
"@vukvukovich/[email protected]"
],
"env": {
"HS_MCP_TOOLS": "safe",
"HS_MCP_TRANSPORT": "socket",
"HS_MCP_LOG_LEVEL": "info"
}
}
}
}extensions:
"hammerspoon-mcp":
enabled: true
name: "hammerspoon-mcp"
type: stdio
cmd: "npx"
args:
- "-y"
- "@vukvukovich/[email protected]"
envs:
"HS_MCP_TOOLS": "safe"
"HS_MCP_TRANSPORT": "socket"
"HS_MCP_LOG_LEVEL": "info"
timeout: 300
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulnsno known advisory in 4 resolved packagesdeps.mcp_sdk_version@modelcontextprotocol/server 2.1.0, no known advisorydeps.resolvable@vukvukovich/[email protected] resolved: 4 packagesNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo ~liveness-unmeasured ~updated-67d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
@vukvukovich/[email protected] npm3 dependencies, resolved · MCP SDK @modelcontextprotocol/server 2.1.0 · advisories checked 2026-10-19
No known advisory affects this dependency graph.
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
@vukvukovich/hammerspoon-mcp | npm | 0.4.0 | – |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
{
"name": "io.github.vukvukovich/hammerspoon-mcp",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.4.0",
"packages": [
{
"version": "0.4.0",
"transport": {
"type": "stdio"
},
"identifier": "@vukvukovich/hammerspoon-mcp",
"registryType": "npm",
"environmentVariables": [
{
"name": "HS_MCP_TOOLS",
"default": "safe",
"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."
},
{
"name": "HS_MCP_TRANSPORT",
"default": "socket",
"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."
},
{
"name": "HS_MCP_HS_PATH",
"description": "Explicit path to the Hammerspoon hs command line tool. Only needed when Hammerspoon is installed somewhere unusual."
},
{
"name": "HS_MCP_DOCS_PATH",
"description": "Explicit path to Hammerspoon's bundled docs.json, used by hs_api_search."
},
{
"name": "HS_MCP_LOG_LEVEL",
"default": "info",
"description": "Log verbosity on stderr: debug, info (default), warn, or error."
}
]
}
],
"repository": {
"url": "https://github.com/vukvukovich/hammerspoon-mcp",
"source": "github"
},
"description": "Control macOS through Hammerspoon: windows, apps, and API search. Injection-safe by design."
}