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>

快速开始

安装

Claude Desktop

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

<details> <summary>开发/未发布服务器配置</summary> ``` "mcpServers": { "mcp-server-macos-defaults": { "command": "uv", "args": [ "--directory", "/path/to/mcp-server-macos-defaults", "run", "mcp-server-macos-defaults" ] } } ``` </details> <details> <summary>已发布服务器配置</summary> ``` "mcpServers": { "mcp-server-macos-defaults": { "command": "uvx", "args": [ "mcp-server-macos-defaults" ] } } ``` </details>

开发

构建和发布

为了准备分发的包：

1. 同步依赖并更新锁文件：

uv sync

2. 构建包分布：

uv build

这将在dist/目录中创建源码和wheel分发包。

3. 发布到PyPI：

uv publish

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

• Token: --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过标准I/O运行，调试可能会很困难。为了获得最佳的调试体验，我们强烈推荐使用MCP Inspector。

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

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

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