apple-notifier-mcp

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides access to Apple's macOS system services including notifications, dialogs, text-to-speech, screenshot capture, and file selection functionality.

  • Enables sending native macOS notifications, displaying interactive dialog prompts, using text-to-speech capabilities, capturing screenshots, and accessing the native file picker dialog.

Apple Notifier MCP 서버

Claude Desktop이나 Cline 등 MCP 호환 클라이언트를 통해 기본 macOS 알림을 보내고 시스템 대화 상자와 상호 작용하세요.

필수 조건

  • 맥OS
  • 노드.js >= 18
  • MCP 호환 클라이언트(Claude Desktop, Cline)

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Apple Notifier를 자동으로 설치하려면:

지엑스피1

수동 설치

  1. 패키지를 전역으로 설치합니다.
npm install -g apple-notifier-mcp
  1. MCP 구성 파일에 다음을 추가합니다.

Cline의 경우( cline_mcp_settings.json ):

{ "mcpServers": { "apple-notifier": { "command": "apple-notifier-mcp" } } }

Claude Desktop( claude_desktop_config.json )의 경우:

{ "mcpServers": { "apple-notifier": { "command": "apple-notifier-mcp" } } }

특징

알림 보내기

사용자 정의 가능한 콘텐츠로 기본 macOS 알림을 표시합니다.

매개변수:

  • title (필수): 문자열 - 알림의 제목
  • message (필수): 문자열 - 주요 메시지 내용
  • subtitle (선택 사항): 문자열 - 표시할 자막
  • sound (선택 사항): boolean - 기본 알림 사운드를 재생할지 여부(기본값: true)

프롬프트 표시

사용자 입력을 얻기 위해 대화형 대화 상자를 표시합니다.

매개변수:

  • message (필수): 문자열 - 프롬프트 대화 상자에 표시할 텍스트
  • defaultAnswer (선택 사항): 문자열 - 미리 채울 기본 텍스트
  • buttons (선택 사항): string[] - 사용자 정의 버튼 레이블(최대 3개)
  • icon (선택 사항): '참고' | '중지' | '주의' - 표시할 아이콘

텍스트 음성 변환

macOS 텍스트-음성 기능을 사용하세요.

매개변수:

  • text (필수): 문자열 - 말할 텍스트
  • voice (선택 사항): 문자열 - 사용할 음성(기본값은 시스템 음성)
  • rate (선택 사항): 숫자 - 음성 속도(-50~50, 기본값은 0)

스크린샷 찍기

macOS 화면캡처를 사용하여 스크린샷을 캡처하세요.

매개변수:

  • path (필수): 문자열 - 스크린샷을 저장할 경로
  • type (필수): '전체 화면' | '창' | '선택' - 스크린샷 유형
  • format (선택 사항): 'png' | 'jpg' | 'pdf' | 'tiff' - 이미지 형식
  • hideCursor (선택 사항): boolean - 커서를 숨길지 여부
  • shadow (선택 사항): boolean - 창 그림자를 포함할지 여부(창 유형에만 해당)
  • timestamp (선택 사항): boolean - 파일 이름에 타임스탬프 추가

파일 선택

기본 macOS 파일 선택기 대화상자를 엽니다.

매개변수:

  • prompt (선택 사항): 문자열 - 프롬프트 메시지
  • defaultLocation (선택 사항): 문자열 - 기본 디렉토리 경로
  • fileTypes (선택 사항): object - 파일 유형 필터(예: {"public.image": ["png", "jpg"]})
  • multiple (선택 사항): boolean - 여러 파일 선택 허용

사용 예

// Send a notification await client.use_mcp_tool("apple-notifier", "send_notification", { title: "Hello", message: "World", sound: true }); // Show a prompt const result = await client.use_mcp_tool("apple-notifier", "prompt_user", { message: "What's your name?", defaultAnswer: "John Doe", buttons: ["OK", "Cancel"] }); // Speak text await client.use_mcp_tool("apple-notifier", "speak", { text: "Hello, world!", voice: "Samantha", rate: -20 }); // Take a screenshot await client.use_mcp_tool("apple-notifier", "take_screenshot", { path: "screenshot.png", type: "window", format: "png" }); // Select files const files = await client.use_mcp_tool("apple-notifier", "select_file", { prompt: "Select images", fileTypes: { "public.image": ["png", "jpg", "jpeg"] }, multiple: true });

기여하다

개발 설정 및 지침은 CONTRIBUTING.md를 참조하세요.

특허

MIT 라이센스 - 자세한 내용은 LICENSE 파일을 참조하세요.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Mac 기기에 알림을 보낼 수 있는 간단한 MCP 서버입니다.

  1. Prerequisites
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Features
      1. Send Notifications
      2. Display Prompts
      3. Text-to-Speech
      4. Take Screenshots
      5. File Selection
    3. Example Usage
      1. Contributing
        1. License
          ID: t1w1dq4wy4