Apple Notifier MCP 서버

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

필수 조건

• 맥OS

• 노드.js >= 18

• MCP 호환 클라이언트(Claude Desktop, Cline)

Related MCP server: Toast MCP Server

설치

Smithery를 통해 설치

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

지엑스피1

수동 설치

1. 패키지를 전역으로 설치합니다.

npm install -g apple-notifier-mcp

2. 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 파일을 참조하세요.