macOS Defaults MCP Server

by g0t4

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables reading and writing macOS defaults (system and application settings) through tools for listing domains, finding settings, and reading/writing configuration values.

Servidor MCP predeterminado de MacOS

Servidor MCP para leer y escribir valores predeterminados de macOS (configuración)

Componentes

Herramientas

  • list-domains :
    • equivalente a ejecutar defaults domains
  • find :
    • equivalente a ejecutar defaults find <word>
  • defaults-read :
    • equivalente a ejecutar defaults read <domain> <key>
    • Si no se proporciona key , se lee todo el dominio
  • defaults-write :
    • equivalente a ejecutar defaults write <domain> <key> <value>

Inicio rápido

Instalar

Escritorio de Claude

En MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

Desarrollo

Construcción y publicación

Para preparar el paquete para su distribución:

  1. Sincronizar dependencias y actualizar el archivo de bloqueo:
uv sync
  1. Distribuciones de paquetes de compilación:
uv build

Esto creará distribuciones de origen y de rueda en el directorio dist/ .

  1. Publicar en PyPI:
uv publish

Nota: Deberás configurar las credenciales de PyPI a través de variables de entorno o indicadores de comando:

  • Token: --token o UV_PUBLISH_TOKEN
  • O nombre de usuario/contraseña: --username / UV_PUBLISH_USERNAME y --password / UV_PUBLISH_PASSWORD

Depuración

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp-server-macos-defaults run mcp-server-macos-defaults

Al iniciarse, el Inspector mostrará una URL a la que podrá acceder en su navegador para comenzar a depurar.

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Servidor MCP que permite leer y escribir las preferencias del sistema macOS y la configuración de las aplicaciones a través del sistema predeterminado.

  1. Components
    1. Tools
  2. Quickstart
    1. Install
  3. Development
    1. Building and Publishing
    2. Debugging
ID: ylg0zlh90i