mac-messages-mcp

Mac メッセージ MCP

MCP (Multiple Context Protocol) を使用して macOS メッセージ アプリと対話するための Python ブリッジ。

特徴

• macOS メッセージアプリから最近のメッセージを読む
• 連絡先別にメッセージをフィルタリング
• iMessageで新しいメッセージを送信する
• API経由でメッセージにアクセスする

前提条件

• macOS（macOS 11以降でテスト済み）
• Python 3.10以上
• UVパッケージマネージャー

uvのインストール

Mac を使用している場合は、Homebrew を使用して uv をインストールします。

それ以外の場合は、 uv Web サイトのインストール手順に従ってください。

⚠️ uvをインストールする前に先に進まないでください

インストール

フルディスクアクセス許可

⚠️ このアプリケーションでは、端末またはアプリケーションがメッセージ データベースにアクセスするために**、フル ディスク アクセス**権限が必要です。

フルディスクアクセスを許可するには:

1. システム環境設定/設定>セキュリティとプライバシー/プライバシー>フルディスクアクセスを開きます
2. 変更するにはロックアイコンをクリックしてください
3. ターミナルアプリ（Terminal、iTerm2など）またはClaude Desktop/Cursorをリストに追加します
4. 許可を与えた後、端末またはアプリケーションを再起動してください

統合

クロードデスクトップ統合

1. Claude >設定>開発者>設定の編集> claude_desktop_config.jsonに移動します。
2. 次の構成を追加します。

カーソル統合

「カーソル設定」 > **「MCP」**に移動し、これをコマンドとして貼り付けます。

⚠️ MCP サーバーのインスタンスを 1 つだけ実行します (Cursor または Claude Desktop のいずれか)。両方実行しないでください。

オプション1: PyPIからインストールする

オプション2: ソースからインストールする

使用法

モジュールとして

コマンドラインツールとして

発達

バージョン管理

このプロジェクトではセマンティックバージョニングを使用しています。バージョニングシステムの仕組みと新しいバージョンのリリース方法の詳細については、 VERSIONING.mdをご覧ください。

バージョンを上げるには:

セキュリティノート

このアプリケーションは、個人的なコミュニケーションが含まれるメッセージデータベースに直接アクセスします。責任を持ってご利用いただき、適切な権限をお持ちであることをご確認ください。

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。