Macos Defaults

🚀 MCP 服務器 macOS 默認設置

本項目是一個用於讀取/寫入 macOS 默認值（設置）的 MCP 服務器，為用戶提供了便捷的方式來操作 macOS 的系統設置。

🚀 快速開始

📦 安裝指南

適用於 Claude 的桌面

• macOS 系統：配置文件路徑為 ~/Library/Application\ Support/Claude/claude_desktop_config.json。
• Windows 系統：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json%。

✨ 主要特性

工具介紹

• list-domains：該工具等效於運行 defaults domains。
• find：等效於運行 defaults find <word>。
• defaults-read：
  • 若提供 key，等效於運行 defaults read <domain> <key>。
  • 若未提供 key，則讀取整個域。
• defaults-write：等效於運行 defaults write <domain> <key> <value>。

🔧 技術細節

構建和發佈

要準備分發包，可按以下步驟操作：

1. 同步依賴項並更新鎖定文件：

uv sync

2. 構建包分佈：

uv build

此操作將在 dist/ 目錄中創建源代碼和輪分佈。 3. 發佈到 PyPI：

uv publish

⚠️ 重要提示： 你需要通過環境變量或命令行參數設置 PyPI 憑證：

• 令牌：--token 或 UV_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

在啟動後，Inspector 會顯示一個 URL，你可以在瀏覽器中訪問該 URL 開始調試。