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.

mcp-server-macos-defaults MCP 服务器

用于读取/写入 macOS 默认设置 (设置) 的 MCP 服务器

成分

工具

  • list-domains
    • 相当于运行defaults domains
  • find
    • 相当于运行defaults find <word>
  • defaults-read
    • 相当于运行defaults read <domain> <key>
    • 如果没有提供key ,则读取整个域
  • defaults-write
    • 相当于运行defaults write <domain> <key> <value>

快速入门

安装

克劳德桌面

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

发展

构建和发布

准备分发包:

  1. 同步依赖项并更新锁文件:
uv sync
  1. 构建软件包分发版:
uv build

这将在dist/目录中创建源和轮子分布。

  1. 发布到 PyPI:
uv publish

注意:您需要通过环境变量或命令标志设置 PyPI 凭据:

  • 令牌: --tokenUV_PUBLISH_TOKEN
  • 或用户名/密码: --username / UV_PUBLISH_USERNAME--password / UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器通过 stdio 运行,调试起来可能比较困难。为了获得最佳调试体验,我们强烈建议使用MCP Inspector

您可以使用以下命令通过npm启动 MCP Inspector:

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

启动后,检查器将显示一个 URL,您可以在浏览器中访问该 URL 以开始调试。

You must be authenticated.

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

MCP 服务器,可通过默认系统读取和写入 macOS 系统偏好设置和应用程序设置。

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