Claude와 같은 AI 비서가 Apple Shortcs 자동화를 제어할 수 있게 해주는 Model Context Protocol(MCP) 서버입니다. 이를 통해 AI 모델이 macOS에서 단축키를 트리거하고 작업을 안전하고 통제된 방식으로 자동화할 수 있습니다.

MCP란 무엇인가? 🤔

모델 컨텍스트 프로토콜(MCP)은 Claude Desktop과 같은 AI 앱이 외부 도구와 데이터 소스에 연결할 수 있게 해주는 시스템입니다. 이 프로토콜은 AI 어시스턴트가 로컬 서비스와 API를 다루면서 사용자가 직접 제어할 수 있도록 명확하고 안전하게 작동할 수 있도록 합니다.

이 서버는 무엇을 하는 걸까요? 🚀

애플 단축어 MCP 서버:

• AI 비서가 사용 가능한 단축키를 나열할 수 있게 합니다
• 선택적 입력 매개변수와 함께 이름별로 단축키를 실행할 수 있습니다
• 자동화 제어를 위한 간단한 인터페이스 제공

선수 조건 📋

시작하기 전에 다음을 확인하세요:

• Node.js (v18 이상)
• 클로드 데스크톱 설치
• 바로가기 앱 설정 포함된 macOS

애플 바로가기 서버 ⚙️ 사용 설정

다음은 Apple Shortcuts 서버를 사용하는 Claude Desktop 설정입니다:

애플 바로가기 서버를 구축하고 로컬에서 🛠️ 실행하세요

1. 이 저장소를 복제:

2. 의존성 설치:

3. 건설 프로젝트

Apple Shortcuts MCP Server 🤖

A Model Context Protocol (MCP) server that lets AI assistants like Claude control Apple Shortcuts automations. This enables AI models to trigger shortcuts and automate tasks on macOS in a safe and controlled way.

What is MCP? 🤔

The Model Context Protocol (MCP) is a system that lets AI apps, like Claude Desktop, connect to external tools and data sources. It gives a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.

What does this server do? 🚀

The Apple Shortcuts MCP server:

• Enables AI assistants to list available shortcuts
• Allows running shortcuts by name with optional input parameters
• Provides a simple interface for automation control

Prerequisites 📋

Before you begin, ensure you have:

• Node.js (v18 or higher)
• Claude Desktop installed
• macOS with Shortcuts app configured

Configuration to use Apple Shortcuts Server ⚙️

Here’s the Claude Desktop configuration to use the Apple Shortcuts server:

{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "npx",
      "args": ["-y", "mcp-server-apple-shortcuts"]
    }
  }
}

Build Apple Shortcuts Server and run locally 🛠️

1. Clone this repository:

git clone [email protected]:recursechat/mcp-server-apple-shortcuts.git

2. Install dependencies:

npm install

3. Build project

npm run build

Here’s the Claude Desktop configuration to use the Apple Shortcuts server with a local build:

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

Usage 🎯

You can ask Claude “list shortcuts” or run a specific shortcut with the shortcut name, for example “get word of the day” or “play a song”.

License ⚖️

Apache-2.0