モデルコンテキストプロトコル(MCP)サーバーで、ClaudeのようなAIアシスタントがAppleショートカットの自動化を制御できます。これにより、AIモデルがショートカットをトリガーし、macOS上で安全かつ制御された方法でタスクを自動化できるようになります。

MCPとは何か?🤔

モデルコンテキストプロトコル(MCP)は、Claude DesktopのようなAIアプリが外部ツールやデータソースに接続できるようにするシステムです。これは、AIアシスタントがローカルサービスやAPIと明確かつ安全に連携しつつ、ユーザーがコントロールできる方法を提供します。

このサーバーは何をしているの?🚀

AppleショートカットのMCPサーバー:

• AIアシスタントが利用可能なショートカットを一覧表示できるようにします
• 名前でショートカットを実行可能で、オプションの入力パラメータを使えます
• 自動化制御のためのシンプルなインターフェースを提供します

前提条件 📋

始める前に、以下のことを確認してください:

• Node.js(v18以上)
• Claude Desktop インストール済み
• macOSでショートカットアプリが設定されています

Apple Shortcuts Server ⚙️ を使用する設定

こちらがAppleショートカットサーバーを使うためのClaude Desktopの設定です:

Appleショートカットサーバーを構築してローカルで🛠️実行する

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