MCP Server Apple Shortcuts

🚀 Apple Shortcuts MCP サーバー 🤖

このサーバーは、Model Context Protocol (MCP) を利用したシステムで、Claude などの AI アシスタントが Apple Shortcuts の自動化を制御できるようにします。これにより、AI モデルは macOS 上でショートカットをトリガーし、安全かつ制御可能な方法でタスクを自動化できます。

🚀 クイックスタート

前提条件 📋

使用を開始する前に、以下のソフトウェアがインストールされていることを確認してください。

• Node.js（バージョン 18 以上）
• Claude Desktop
• macOS 上で設定済みの Shortcuts アプリ

サーバーの設定 ⚙️

Claude Desktop で Apple Shortcuts サーバーを使用するには、以下の設定例を参考にしてください。

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

ローカルでのビルドと実行 🛠️

1. このリポジトリをクローンします。

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

2. 依存関係をインストールします。

npm install

3. プロジェクトをビルドします。

npm run build

ローカルでビルドした Apple Shortcuts サーバーを使用する Claude Desktop の設定例は以下の通りです。

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

使用方法 🎯

Claude に「ショートカットを一覧表示」や「「単語を取得」を実行」などの操作を依頼することができます。例えば、「単語を取得」や「曲を再生」などです。

✨ 主な機能

このサーバーの機能 🚀

Apple Shortcuts MCP サーバーは以下の機能を提供します。

• AI アシスタントが利用可能なショートカットを一覧表示できるようにする。
• 名前でショートカットを実行し、必要に応じて入力パラメータを渡すことをサポートする。
• 自動化制御のためのシンプルなインターフェースを提供する。

📚 ドキュメント

什么是 MCP？ 🤔

Model Context Protocol (MCP) は、AI アプリ（Claude Desktop など）が外部のツールやサービスに接続できるようにするシステムです。これにより、AI アシスタントは明確かつ安全な方法でローカルサービスや API とやり取りでき、ユーザーはコントロールを維持できます。

📄 ライセンス

このプロジェクトは Apache-2.0 ライセンスの下で提供されています。