Mac Messages MCP

🚀 macOS メッセージ MCP 読み書きブリッジ（Python 版）

この Python ブリッジは、MCP（マルチコンテキストプロトコル）を介して macOS Messages アプリケーションとやり取りするためのものです。

✨ 主な機能

• macOS Messages アプリケーションの最近のメッセージを読み取る
• 連絡先でメッセージをフィルタリングする
• iMessage を介して新しいメッセージを送信する
• API を通じてメッセージにアクセスする

📦 インストール

前提条件

• macOS（macOS 11+ での動作をテスト済み）
• Python 3.10+
• uv パッケージマネージャー

uv のインストール

Mac を使用している場合は、Homebrew を通じて uv をインストールしてください。

brew install uv

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

⚠️ 重要提示

uv をインストールする前に、作業を続けないでください。

フルディスクアクセス権限

⚠️ 重要提示

このアプリケーションは、Messages データベースにアクセスするために、ターミナルまたはアプリケーションにフルディスクアクセス権限を付与する必要があります。

フルディスクアクセス権限を設定する手順：

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

インストールオプション

オプション 1：PyPI からインストール

uv pip install mac-messages-mcp

オプション 2：ソースコードからインストール

# リポジトリをクローンする
git clone https://github.com/carterlasalle/mac_messages_mcp.git
cd mac_messages_mcp

# 依存関係をインストールする
uv install -e .

📚 ドキュメント

統合

Claude Desktop 統合

1. Claude > 設定 > 開発者 > 設定を編集 > claude_desktop_config.json に移動する
2. 以下の設定を追加する：

{
    "mcpServers": {
        "messages": {
            "command": "uvx",
            "args": [
                "mac-messages-mcp"
            ]
        }
    }
}

Cursor 統合

Cursor Settings > MCP に移動し、以下のコマンドを貼り付ける：

uvx mac-messages-mcp

⚠️ 重要提示

MCP サーバーのインスタンスは 1 つだけ実行できます（Claude Desktop または Cursor のどちらか一方）。両方を同時に実行しないでください。

使用方法

モジュールとして使用する

from mac_messages_mcp import get_recent_messages, send_message

# 最近のメッセージを取得する
messages = get_recent_messages(hours=48)
print(messages)

# メッセージを送信する
result = send_message(recipient="+1234567890", message="Hello from Mac Messages MCP!")
print(result)

コマンドラインツールとして使用する

# MCP サーバーを起動する
mac-messages-mcp

開発

バージョン管理

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

バージョンを調整するには：

python scripts/bump_version.py [patch|minor|major]

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

このアプリケーションは、Messages データベースに直接アクセスするため、権限とデータセキュリティを適切に管理する必要があります。

追加情報

MCP プロトコルの概要

MCP（マルチコンテキストプロトコル）は、異なるプロセスまたはサービス間で通信するためのメカニズムです。このプロジェクトでは、MCP を使用して Python スクリプトと macOS Messages アプリケーションの間のやり取りを橋渡ししています。

サポートされているメッセージ操作

現在、以下のメッセージ関連の操作がサポートされています：

• 最近のメッセージを取得する
• 連絡先でメッセージをフィルタリングする
• 新しいメッセージを送信する

将来の開発計画

将来的には、以下のような機能を追加する予定です：

• より多くのメッセージタイプをサポートする
• グラフィカルユーザーインターフェイスを提供する
• セキュリティと安定性を強化する

貢献者

このプロジェクトは、carterlasalle によって開発および保守されています。

📄 ライセンス

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