AgentHubAgentHub

macos-mcp-server

MCP ServerMCP Registry官方收录

io.github.cyanheads/macos-mcp-server · v0.1.3

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

源仓库 ↗

概览

macos-mcp-server 是一个MCP Server，收录自 官方 MCP Registry。支持 stdio、streamable-http 传输。本页提供 Cursor、Claude Code 等客户端的安装配置片段。

安装

选择你的平台查看安装方式

{
  "mcpServers": {
    "macos-mcp-server": {
      "command": "node",
      "args": [
        "-y",
        "@cyanheads/macos-mcp-server"
      ]
    }
  }
}

环境变量

MACOS_SCREENSHOT_DIR可选

Default directory for screenshot files. Defaults to ~/Desktop when empty.

MACOS_DISPLAY_LAYOUTS可选

JSON object mapping layout names to displayplacer argument strings for apply_layout.

MCP_LOG_LEVEL可选

Minimum log level for output: debug, info, notice, warning, error.

MACOS_SCREENSHOT_DIR可选

Default directory for screenshot files. Defaults to ~/Desktop when empty.

MACOS_DISPLAY_LAYOUTS可选

JSON object mapping layout names to displayplacer argument strings for apply_layout.

MCP_HTTP_HOST可选

The hostname for the HTTP server.

MCP_HTTP_PORT可选

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATH可选

The endpoint path for the MCP server.

MCP_AUTH_MODE可选

Authentication mode: none, jwt, or oauth.

MCP_LOG_LEVEL可选

Minimum log level for output: debug, info, notice, warning, error.

相关资源

统一 Manifest

{
  "id": "io.github.cyanheads/macos-mcp-server",
  "type": "mcp-server",
  "version": "0.1.3",
  "displayName": "macos-mcp-server",
  "description": "Control macOS system settings, apps, windows, audio, displays, screenshots, and Focus mode via MCP.",
  "repository": {
    "url": "https://github.com/cyanheads/macos-mcp-server",
    "source": "github"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "@cyanheads/macos-mcp-server",
        "version": "0.1.3",
        "runtimeHint": "node",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "MACOS_SCREENSHOT_DIR",
            "description": "Default directory for screenshot files. Defaults to ~/Desktop when empty."
          },
          {
            "name": "MACOS_DISPLAY_LAYOUTS",
            "description": "JSON object mapping layout names to displayplacer argument strings for apply_layout."
          },
          {
            "name": "MCP_LOG_LEVEL",
            "description": "Minimum log level for output: debug, info, notice, warning, error."
          }
        ]
      },
      {
        "registryType": "npm",
        "identifier": "@cyanheads/macos-mcp-server",
        "version": "0.1.3",
        "runtimeHint": "node",
        "transport": "streamable-http",
        "environmentVariables": [
          {
            "name": "MACOS_SCREENSHOT_DIR",
            "description": "Default directory for screenshot files. Defaults to ~/Desktop when empty."
          },
          {
            "name": "MACOS_DISPLAY_LAYOUTS",
            "description": "JSON object mapping layout names to displayplacer argument strings for apply_layout."
          },
          {
            "name": "MCP_HTTP_HOST",
            "description": "The hostname for the HTTP server."
          },
          {
            "name": "MCP_HTTP_PORT",
            "description": "The port to run the HTTP server on."
          },
          {
            "name": "MCP_HTTP_ENDPOINT_PATH",
            "description": "The endpoint path for the MCP server."
          },
          {
            "name": "MCP_AUTH_MODE",
            "description": "Authentication mode: none, jwt, or oauth."
          },
          {
            "name": "MCP_LOG_LEVEL",
            "description": "Minimum log level for output: debug, info, notice, warning, error."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.cyanheads/macos-mcp-server",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.cyanheads%2Fmacos-mcp-server/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
macos-mcp-server — MCP Server 安装与配置 · AgentHub