local-only server

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

Integrations

Enables AI assistants to control Apple Shortcuts automations on macOS, including listing available shortcuts and running shortcuts by name with optional input parameters
Provides integration with macOS through Apple Shortcuts, allowing automation of tasks on the macOS platform

Apple 단축키 MCP 서버 🤖

Claude와 같은 AI 비서가 Apple Shortcuts 자동화를 제어할 수 있도록 하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이를 통해 AI 모델은 macOS에서 안전하고 제어된 방식으로 단축키를 트리거하고 작업을 자동화할 수 있습니다.

MCP란 무엇인가요? 🤔

모델 컨텍스트 프로토콜(MCP)은 Claude Desktop과 같은 AI 앱이 외부 도구 및 데이터 소스에 연결할 수 있도록 하는 시스템입니다. AI 어시스턴트가 사용자의 제어권을 유지하면서 로컬 서비스 및 API를 사용할 수 있는 명확하고 안전한 방법을 제공합니다.

이 서버는 무슨 역할을 하나요? 🚀

Apple Shortcuts MCP 서버:

AI 어시스턴트가 사용 가능한 단축키를 나열할 수 있도록 합니다.
선택적 입력 매개변수를 사용하여 이름으로 바로가기를 실행할 수 있습니다.
자동화 제어를 위한 간단한 인터페이스를 제공합니다

필수 조건 📋

시작하기 전에 다음 사항을 확인하세요.

Node.js (v18 이상)
Claude Desktop 설치됨
단축키 앱이 구성된 macOS

Apple Shortcuts Server를 사용하기 위한 구성 ⚙️

Apple 단축키 서버를 사용하기 위한 Claude Desktop 구성은 다음과 같습니다.

지엑스피1

Apple Shortcuts 서버를 빌드하고 로컬에서 실행하세요 🛠️

이 저장소를 복제하세요:

git clone git@github.com:recursechat/mcp-server-apple-shortcuts.git

종속성 설치:

npm install

프로젝트 빌드

npm run build

로컬 빌드에서 Apple Shortcuts 서버를 사용하기 위한 Claude Desktop 구성은 다음과 같습니다.

{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "npx",
      "args": ["/path/to/mcp-server-apple-shortcuts/build/index.js"],
    }
  }
}

사용법 🎯

클로드에게 "단축키 나열"을 요청하거나, 단축키 이름을 사용해 특정 단축키를 실행할 수 있습니다. 예를 들어, "오늘의 단어 가져오기" 또는 "노래 재생"이라고 할 수 있습니다.

라이센스 ⚖️

아파치-2.0

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

Apple Shortcuts와 MCP 서버 통합