AppleScript MCP 서버

“AppleScript” MCP 서버는 무엇을 하나요?

AppleScript MCP 서버는 AI 어시스턴트와 개발 도구가 Mac에서 AppleScript 코드를 실행할 수 있도록 해주는 Model Context Protocol(MCP) 서버입니다. 이 서버는 브릿지 역할을 하며, AI 에이전트가 Notes, Calendar, Contacts, Messages 등 다양한 Mac 애플리케이션과 시스템 기능을 제어하고 접근할 수 있게 해줍니다. Spotlight를 통한 파일 검색, 파일 읽기/쓰기, 셸 명령 실행, SSH를 통한 원격 실행 등 다양한 작업을 지원합니다. 직관적이고 가벼운 설계로 손쉽게 통합할 수 있어, Mac 사용자의 자동화, 생산성, 개발 워크플로우를 크게 향상시키며 macOS의 광범위한 기능에 프로그래밍 방식으로 접근할 수 있습니다.

프롬프트 목록

저장소에는 재사용 가능한 프롬프트 템플릿이 문서화되어 있지 않습니다. 사용자에게 제공되는 예시 프롬프트만 있습니다.

리소스 목록

사용 가능한 문서나 코드에 명시적인 MCP 리소스가 설명되어 있지 않습니다.

도구 목록

server.js나 문서에 상세 도구 목록이 제공되어 있지 않습니다. 서버는 임의의 AppleScript 실행을 지원하지만, 구체적인 도구 프리미티브는 명시되어 있지 않습니다.

이 MCP 서버의 활용 사례

• Mac 애플리케이션 자동화: 개발자와 AI 에이전트가 Notes, Calendar, Contacts, Messages 등 macOS 앱을 AppleScript 명령으로 자동화할 수 있습니다.
• 파일 및 시스템 관리: Spotlight나 Finder를 이용한 파일 검색, 파일 내용 읽기/쓰기, 폴더 및 문서의 프로그래밍적 관리를 지원합니다.
• 시스템 정보 조회: 배터리 잔량, 디스크 용량, 실행 중인 애플리케이션 등 시스템 상태 질의를 지원하여 사용자와 자동화 에이전트 모두에게 유용합니다.
• 원격 실행: SSH를 통한 원격 AppleScript 실행을 지원하여, 다른 머신이나 컨테이너에서 Mac을 관리할 수 있습니다.
• 미디어 및 커뮤니케이션 제어: Apple Music 등 미디어 재생 제어 및 이메일, 메시지, 알림 자동화 등 커뮤니케이션 앱과 상호작용할 수 있습니다.

설치 방법

Windsurf

1. 시스템에 Node.js가 설치되어 있는지 확인하세요.
2. Windsurf 설정 파일을 엽니다.
3. 아래 JSON 스니펫을 참고해 AppleScript MCP 서버를 mcpServers 섹션에 추가하세요.
4. 설정을 저장하고 Windsurf를 재시작하세요.
5. 서버가 정상적으로 실행되고 접근 가능한지 확인하세요.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Claude

1. Node.js가 설치되어 있는지 확인하세요.
2. Claude 설정 파일을 찾아 엽니다.
3. 아래 예시처럼 MCP 서버를 추가하세요.
4. 설정을 저장하고 Claude를 재시작하세요.
5. MCP 서버가 사용 가능한지 확인하세요.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cursor

1. 시스템에 Node.js를 설치하세요.
2. Cursor의 설정 파일을 엽니다.
3. mcpServers 섹션에 AppleScript MCP 서버 항목을 삽입하세요.
4. 저장 후 Cursor를 재시작하세요.
5. 통합 성공을 확인하세요.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cline

1. Node.js가 설치되어 있는지 확인하세요.
2. Cline 설정 파일을 수정하세요.
3. 아래 예시처럼 MCP 서버 구성을 추가하세요.
4. 변경 사항을 저장하고 Cline을 재시작하세요.
5. MCP 서버가 정상적으로 동작하는지 테스트하세요.

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

API 키 및 자격증명 보안

원격 실행 시 SSH 사용자명, 비밀번호 등 민감 정보는 환경 변수를 통해 보다 안전하게 제공할 수 있습니다. 예시:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ],
      "env": {
        "REMOTE_USER": "yourusername",
        "REMOTE_PASSWORD": "yourpassword"
      },
      "inputs": {
        "remoteHost": "host.docker.internal"
      }
    }
  }
}

흐름 내에서 MCP를 사용하는 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, 플로우에 MCP 컴포넌트를 추가하고 AI 에이전트에 연결하세요:

MCP 컴포넌트를 클릭해 설정 패널을 엽니다. 시스템 MCP 설정 섹션에 아래 JSON 형식으로 MCP 서버 정보를 입력하세요:

{
  "applescript_execute": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면 AI 에이전트가 이 MCP를 도구로 사용하여 모든 기능과 역량에 접근할 수 있습니다. “applescript_execute"를 실제 MCP 서버 이름으로, URL도 본인 MCP 서버의 URL로 변경해 주세요.

개요

위 표에 따르면 AppleScript MCP 서버는 직관적이지만 다소 제한적인 통합을 제공합니다. 강점은 AppleScript를 통한 Mac 직접 제어에 있으나, 프롬프트 템플릿·명시적 MCP 리소스·상세 도구 프리미티브 문서화가 부족합니다. 라이선스 존재, 보통 이상의 인기, 명확한 설치 안내 등은 긍정적 요소입니다. 전반적으로 특정 분야엔 매우 유용하지만, 문서화 깊이는 아쉬운 편입니다.

MCP 점수