MCP Server MCP

io.github.cyanheads/macos-mcp-server

By github 👁 1 views ▲ 0 votes

Control macOS system settings, apps, windows, audio, displays, screenshots, and Focus mode via MCP.

Homepage Verified source GitHub

Install

npx -y @cyanheads/[email protected]

Configuration Example

{
  "remotes": [],
  "packages": [
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "@cyanheads/macos-mcp-server",
      "version": "0.1.5",
      "runtimeHint": "node",
      "transport": {
        "type": "stdio"
      },
      "packageArguments": [
        {
          "value": "run",
          "type": "positional"
        },
        {
          "value": "start:stdio",
          "type": "positional"
        }
      ],
      "environmentVariables": [
        {
          "description": "Default directory for screenshot files. Defaults to ~/Desktop when empty.",
          "format": "string",
          "name": "MACOS_SCREENSHOT_DIR"
        },
        {
          "description": "JSON object mapping layout names to displayplacer argument strings for apply_layout.",
          "format": "string",
          "default": "{}",
          "name": "MACOS_DISPLAY_LAYOUTS"
        },
        {
          "description": "Minimum log level for output: debug, info, notice, warning, error.",
          "format": "string",
          "default": "info",
          "name": "MCP_LOG_LEVEL"
        }
      ]
    },
    {
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "identifier": "@cyanheads/macos-mcp-server",
      "version": "0.1.5",
      "runtimeHint": "node",
      "transport": {
        "type": "streamable-http",
        "url": "http://localhost:3010/mcp"
      },
      "packageArguments": [
        {
          "value": "run",
          "type": "positional"
        },
        {
          "value": "start:http",
          "type": "positional"
        }
      ],
      "environmentVariables": [
        {
          "description": "Default directory for screenshot files. Defaults to ~/Desktop when empty.",
          "format": "string",
          "name": "MACOS_SCREENSHOT_DIR"
        },
        {
          "description": "JSON object mapping layout names to displayplacer argument strings for apply_layout.",
          "format": "string",
          "default": "{}",
          "name": "MACOS_DISPLAY_LAYOUTS"
        },
        {
          "description": "The hostname for the HTTP server.",
          "format": "string",
          "default": "127.0.0.1",
          "name": "MCP_HTTP_HOST"
        },
        {
          "description": "The port to run the HTTP server on.",
          "format": "string",
          "default": "3010",
          "name": "MCP_HTTP_PORT"
        },
        {
          "description": "The endpoint path for the MCP server.",
          "format": "string",
          "default": "/mcp",
          "name": "MCP_HTTP_ENDPOINT_PATH"
        },
        {
          "description": "Authentication mode: none, jwt, or oauth.",
          "format": "string",
          "default": "none",
          "name": "MCP_AUTH_MODE"
        },
        {
          "description": "Minimum log level for output: debug, info, notice, warning, error.",
          "format": "string",
          "default": "info",
          "name": "MCP_LOG_LEVEL"
        }
      ]
    }
  ]
}

mcp model-context-protocol npm