mcp-server-macos-defaults MCP server

mcp-server-macos-defaults MCP server

site icon
2024.11.30 11
PythonmacOS 系统设置命令行工具其它
mcp-server-macos-defaults 是一个用于读取和写入 macOS 默认设置(defaults)的 MCP 服务器。它提供了一系列工具来操作 macOS 的系统设置,包括列出域、查找设置、读取和写入默认值等核心功能。
View on GitHub

Overview

基本能力

产品定位

mcp-server-macos-defaults 是一个专门用于操作 macOS 系统设置的 MCP 服务器,它允许用户通过命令行工具读取和修改 macOS 的默认设置。

核心功能

  • 列出域 (list-domains): 相当于运行 defaults domains,列出所有可用的设置域。
  • 查找设置 (find): 相当于运行 defaults find <word>,查找包含特定单词的设置。
  • 读取默认值 (defaults-read): 相当于运行 defaults read <domain> <key>,读取指定域和键的值。如果未提供键,则读取整个域。
  • 写入默认值 (defaults-write): 相当于运行 defaults write <domain> <key> <value>,写入指定域和键的值。

适用场景

  • 系统管理员需要批量修改 macOS 系统设置。
  • 开发人员需要自动化配置开发环境。
  • 用户需要快速查找或修改特定的系统设置。

工具列表

  • list-domains: 列出所有可用的设置域。
  • find: 查找包含特定单词的设置。
  • defaults-read: 读取指定域和键的值。
  • defaults-write: 写入指定域和键的值。

常见问题解答

  • 调试困难: 由于 MCP 服务器通过 stdio 运行,调试可能具有挑战性。建议使用 MCP Inspector 进行调试。

使用教程

使用依赖

无特殊依赖,只需 macOS 系统。

安装教程

  1. Claude Desktop 配置
  2. MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. Windows: %APPDATA%/Claude/claude_desktop_config.json

  4. 开发/未发布服务器配置 json "mcpServers": { "mcp-server-macos-defaults": { "command": "uv", "args": [ "--directory", "/path/to/mcp-server-macos-defaults", "run", "mcp-server-macos-defaults" ] } }

  5. 已发布服务器配置 json "mcpServers": { "mcp-server-macos-defaults": { "command": "uvx", "args": [ "mcp-server-macos-defaults" ] } }

调试方式

使用 MCP Inspector 进行调试:

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

启动后,检查浏览器中显示的 URL 开始调试。

许可证

None