Apple MCP Server

🚀 Apple MCP ツール

このツールは、Apple デバイス向けの MCP プロトコル ツールセットです。Apple MCP を使用することで、Apple の様々なアプリケーションを操作できます。

以下は、設定方法とデモンストレーションの手順を示した動画です。動画を見る

{
  "mcpServers": {
    "apple-mcp": {
      "command": "bunx",
      "args": ["--no-cache", "apple-mcp@latest"]
    }
}

🚀 クイックスタート

📦 インストール

自動インストール

Smithery を通じて、Claude Desktop や Cursor などのクライアントに自動で Apple MCP をインストールできます。

• Claude Desktop 用のインストール

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client claude

• Cursor 用のインストール

npx -y @smithery/cli@latest install @Dhravya/apple-mcp --client cursor

手動インストール

1. Node.js と npm のインストール

# nvm を使用して Node.js 14.x 以上をインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
source ~/.bashrc
nvm install --lts

2. リポジトリのクローンと依存関係のインストール

git clone https://github.com/yourusername/apple-mcp.git
cd apple-mcp
npm install

3. サービスの起動

node index.js

✨ 主な機能

メッセージ

• Apple Messages アプリを使用してメッセージを送信
• メッセージ内容を読み上げ

ノート

• すべてのノートを一覧表示
• Apple Notes アプリ内でノートを検索し、読む

連絡先

• メッセージを送信するための連絡先を検索

メール

• 複数の受信者（CC、BCC を含む）に電子メールを送信
• カスタムクエリ、メールボックス選択、結果制限を使用してメールを検索
• 将来の日時に配信するメールを予約
• 予約されたメールを一覧表示し、管理
• グローバルまたはメールボックスごとの未読メール数を確認

リマインダー

• すべてのリマインダーとリマインダーリストを一覧表示
• テキストでリマインダーを検索
• 新しいリマインダーを作成し、期限とメモを設定することができる
• Reminders アプリ内で特定のリマインダーを開く

カレンダー

• カスタム日付範囲でカレンダーイベントを検索
• 今後の予定を一覧表示
• タイトル、場所、メモなどの詳細を含む新しいカレンダーイベントを作成
• Calendar アプリ内で特定のカレンダーイベントを開く

ウェブ検索

• Google などのプラットフォームでウェブ検索を実行
• 検索結果のリストを取得
• 指定された検索結果のリンクを開く

マップ

• 地理位置を検索し、緯度と経度の座標を取得
• 場所の情報を表示

💻 使用例

基本的な使用法

メールの送信

{
  "command": "send_email",
  "args": {
    "to": "recipient@example.com",
    "subject": "Test Email",
    "body": "This is a test email from the MCP tool."
  }
}

地理位置の検索

{
  "command": "search_location",
  "args": {
    "query": "New York City"
  }
}

高度な使用法

天気情報の取得

{ command: 'get_weather', args: { location: 'London' } }

近くのレストランの検索

{ command: 'search_restaurants', args: { location: 'Tokyo' } }

ローカル開発

1. リポジトリのクローンと依存関係のインストール

git clone https://github.com/yourusername/apple-mcp.git
cd apple-mcp
npm install

2. 開発サーバーの起動

npm run dev

3. 機能のテスト

• http://localhost:3000 にアクセスして、ドキュメントとテスト画面を表示
• 提供されている API エンドポイントを使用して機能をテスト

詳細な情報は、プロジェクトのドキュメントまたはリポジトリ内の README ファイルを参照してください。

📚 ドキュメント

参考資料

• MCP プロトコルの公式ドキュメント
• Smithery プラットフォーム
• Node.js 公式ウェブサイト
• NPM 公式リポジトリ