Imessage

🚀 iMessage MCP サーバー

⚠️ 注意：自己責任で利用してください ⚠️

このソフトウェアは現状のまま提供され、一切の保証や保険はありません。

AppleScript を使用して iMessage を送信し、連絡先を管理する MCP サーバーです。このサーバーは、モデルコンテキストプロトコル (MCP) を介して、AppleScript を使って macOS のメッセージと連絡先アプリケーションとインターフェースします。AppleScript コマンドを TypeScript サーバーにラップすることで、以下のことができます。

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

✨ 主な機能

リソース

• contacts://all を通じて連絡先にアクセスする
• 名前、電話番号、電子メールアドレスを含む連絡先の詳細を表示する
• すべてのデータはあなたのコンピューターにローカルに保存される

ツール

• search_contacts - 名前、電話、または電子メールで連絡先を検索する
  • 検索クエリを受け取り、一致する連絡先を返す
  • 名前、電話番号、および電子メールアドレスで検索する
• send_message - iMessage を送信する
  • 受信者（電話/電子メール）とメッセージ内容を受け取る
  • あなたのローカルのメッセージアプリケーションを通じて送信する
  • 確認またはエラーの詳細を返す

📦 インストール

1. 依存関係をインストールする：

npm install

2. サーバーをビルドする：

npm run build

3. Claude Desktop がこのサーバーを使用するように設定する： MacOS では：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "imessage": {
      "command": "node",
      "args": ["/path/to/imessage-server/build/server.js"]
    }
  }
}

4. Claude Desktop を再起動する
5. ポップアップが表示されたら、以下のアクセス許可を付与する：
   • 連絡先へのアクセス
   • メッセージへのアクセス

💻 使用例

インストールが完了したら、Claude Desktop と自然に会話することができます。

• "私の連絡先を表示して"
• "Marissa という名前の連絡先を検索して"
• "555-0123 に、10 分で到着するというメッセージを送信して"
• "Alice に、ランチの予定がまだかどうか尋ねる iMessage を送信して"

📚 ドキュメント

セキュリティに関する注意事項

• すべての操作はあなたのローカルコンピューター上で行われます
• 連絡先やメッセージデータは外部サーバーに送信されません
• このサーバーは、連絡先とメッセージにアクセスするために macOS のアクセス許可が必要です
• メッセージはあなたの iMessage アカウントを通じて送信されます

開発に関する情報

開発やデバッグには、MCP モニターを使用します。

npx @modelcontextprotocol/inspector node build/server.js

必要条件

• macOS（メッセージと連絡先の統合に必要）
• Node.js 18 以上
• Claude Desktop
• 有効な iMessage アカウント

トラブルシューティング

メッセージが送信されない場合は、以下のことを確認してください。

1. メッセージアプリケーションにログインしていることを確認する
2. アクセス許可が付与されていることを確認する
3. Claude Desktop のログにエラーがないか確認する：

tail -f ~/Library/Logs/Claude/mcp*.log