使用说明

项目简介

mcp-server-macos-defaults 是一个基于 Model Context Protocol (MCP) 的服务器，旨在为大型语言模型 (LLM) 提供访问和操作 macOS 默认设置（Defaults）的功能。通过此服务器，LLM 可以查询系统配置信息，甚至在一定程度上修改系统设置。

主要功能点

列出域 (list-domains): 获取 macOS 系统中可用的 Defaults 域列表，相当于 'defaults domains' 命令。
查找设置 (find): 在 Defaults 中查找包含特定关键词的设置项，相当于 'defaults find <word>' 命令。
读取设置 (defaults-read): 读取指定域和键的 Defaults 值，相当于 'defaults read <domain> <key>' 命令。如果只提供域，则读取整个域的所有设置。
写入设置 (defaults-write): 写入或修改指定域、键和值的 Defaults 设置，相当于 'defaults write <domain> <key> <value>' 命令。

安装步骤

该服务器通常作为 Python 包进行安装和运行。根据仓库 'README.md' 的描述，开发和发布流程使用了 'uv' 工具链。对于最终用户，更可能是通过预打包的方式集成到 MCP 客户端中，例如 Claude Desktop。以下是在 Claude Desktop 中配置该服务器的步骤（假设服务器已安装或可以访问到服务器代码）：

找到 Claude Desktop 配置文件:
- macOS: '~/Library/Application\ Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'
编辑配置文件: 打开 'claude_desktop_config.json' 文件，找到 '"mcpServers"' 部分。如果不存在，则创建该部分。
添加服务器配置: 在 '"mcpServers"' 中添加 'mcp-server-macos-defaults' 服务器的配置信息。根据您的使用场景（开发环境或已发布版本），选择相应的配置。

已发布服务器配置 (Published Servers Configuration): 适用于服务器已打包发布，可以通过 'uvx' 命令直接运行的情况。
```
"mcpServers": {
  "mcp-server-macos-defaults": {
    "command": "uvx",
    "args": [
      "mcp-server-macos-defaults"
    ]
  }
}
```
- 'server name': '"mcp-server-macos-defaults"' - 服务器的名称，用于在 MCP 客户端中标识和引用该服务器。
- 'command': '"uvx"' - 启动服务器的命令。 'uvx' 可能是一个用于运行已打包 Python 应用的执行器。
- 'args': '["mcp-server-macos-defaults"]' - 传递给 'command' 的参数。 '"mcp-server-macos-defaults"' 可能是服务器的可执行文件名或入口点。
开发/未发布服务器配置 (Development/Unpublished Servers Configuration): 适用于在本地开发环境运行服务器，需要指定服务器代码路径的情况。
```
"mcpServers": {
  "mcp-server-macos-defaults": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/mcp-server-macos-defaults",  //  请替换为 mcp-server-macos-defaults 仓库的实际路径
      "run",
      "mcp-server-macos-defaults"
    ]
  }
}
```
- 'server name': '"mcp-server-macos-defaults"' - 服务器的名称。
- 'command': '"uv"' - 启动服务器的命令。 'uv' 是一个 Python 包管理和运行工具。
- 'args':
  - '"--directory", "/path/to/mcp-server-macos-defaults"' - 指定服务器代码所在的目录。请务必将 '"/path/to/mcp-server-macos-defaults"' 替换为您本地 'mcp-server-macos-defaults' 仓库的实际绝对路径。
  - '"run", "mcp-server-macos-defaults"' - 指示 'uv' 运行 'mcp-server-macos-defaults' 作为入口点的服务器程序。

基本使用方法

配置完成后，MCP 客户端（如 Claude Desktop）应该能够检测到并连接到 'mcp-server-macos-defaults' 服务器。 LLM 可以通过调用服务器提供的工具来与 macOS Defaults 系统交互。

例如，LLM 可以指示客户端调用 'list-domains' 工具来获取可用的 Defaults 域列表，或者调用 'defaults-read' 工具并提供 'domain' 和 'key' 参数来读取特定的系统设置。同样，可以使用 'defaults-write' 工具来修改系统设置，但请务必谨慎操作，避免对系统稳定性造成影响。

注意： 修改系统 Defaults 设置可能需要管理员权限，并且不当的修改可能会导致系统不稳定或应用行为异常。请在了解风险的情况下谨慎使用 'defaults-write' 工具。

关键词

使用说明

项目简介

主要功能点

安装步骤

基本使用方法

信息