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 資格情報を設定する必要があります。

  • トークン: --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

起動すると、ブラウザでアクセスしてデバッグを開始できる URL がインスペクタに表示されます。

You must be authenticated.

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

デフォルト システムを通じて macOS システム環境設定とアプリケーション設定の読み取りと書き込みを可能にする MCP サーバー。

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