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. 종속성 동기화 및 잠금 파일 업데이트:

지엑스피1

  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

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 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