iMessage MCP Server

iMessage MCP サーバー

⚠️免責事項 - 自己責任でご利用ください⚠️

このソフトウェアは現状のまま提供され、いかなる保証も付与されません。

AppleScript を使用して iMessage を送信し、連絡先を管理する MCP サーバー。

このサーバーは、AppleScriptを使用して、モデルコンテキストプロトコル（MCP）を介してmacOSのメッセージアプリと連絡先アプリと連携します。AppleScriptコマンドをTypeScriptサーバーにラップすることで、以下のことが可能になります。

• 連絡先の表示と検索
• 連絡先または電話番号にiMessageを送信する
• メッセージが送信されたときに確認を受け取る

特徴

リソース

• contacts://allから連絡先にアクセスします
• 名前、電話番号、メールアドレスなどの連絡先の詳細を表示します
• すべてのデータはローカルマシン上に保存されます

ツール

• search_contacts - 名前、電話番号、またはメールアドレスで連絡先を検索します
  • 検索クエリを受け取り、一致する連絡先を返します
  • 名前、電話番号、メールアドレスを検索
• send_message - iMessage を送信する
  • 受信者（電話番号/メール）とメッセージの内容を取得します
  • ローカルのメッセージアプリから送信
  • 確認またはエラーの詳細を返します

インストール

1. 依存関係をインストールします:

2. サーバーを構築します。

3. サーバーを使用するように Claude Desktop を構成します。

MacOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json

4. Claudeデスクトップを再起動します
5. 次のプロンプトが表示されたら権限を付与します。
   • 連絡先へのアクセス
   • メッセージアクセス

使用法

インストールすると、Claude Desktop と自然に会話できるようになります。

• 「連絡先を見せて」
• 「Marissaという名前の連絡先を検索」
• 「555-0123に10分以内に着くとメッセージを送ってください」
• 「アリスにiMessageを送って、ランチの予定がまだ合うかどうか聞いてみよう」

セキュリティノート

• すべての操作はローカルマシン上で実行されます
• 連絡先やメッセージのデータは外部サーバーに送信されません
• サーバーは連絡先とメッセージへのアクセスにmacOSの権限を必要とします
• メッセージはiMessageアカウントを通じて送信されます

発達

開発とデバッグには、MCP インスペクターを使用します。

要件

• macOS（メッセージと連絡先の統合用）
• Node.js 18以上
• クロードデスクトップ
• アクティブなiMessageアカウント

トラブルシューティング

メッセージが送信されない場合は:

1. メッセージアプリがサインインされているか確認する
2. 権限が付与されていることを確認する
3. Claude Desktop ログでエラーを探します。