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 .

💻 使用示例

作為模塊使用

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

📚 詳細文檔

集成

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 服務器實例（無論是 Claude Desktop 還是 Cursor），不要同時運行兩者。

開發

版本控制

此項目使用語義版本控制。有關版本控制系統如何工作以及如何發佈新版本的詳細信息，請參閱 VERSIONING.md。

要調整版本：

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

安全注意事項

此應用程序直接訪問 Messages 數據庫，需妥善管理權限和數據安全。

附加說明

MCP 協議簡介

MCP（多上下文協議）是一種用於在不同進程或服務之間通信的機制。在此項目中，我們使用 MCP 來橋接 Python 腳本與 macOS Messages 應用程序之間的交互。

支持的消息操作

目前支持以下消息相關操作：

• 獲取最近消息。
• 按聯繫人過濾消息。
• 發送新消息。

未來發展

未來計劃添加更多功能，例如：

• 支持更多消息類型。
• 提供圖形用戶界面。
• 增強安全性與穩定性。

貢獻者

此項目由 carterlasalle 開發和維護。

📄 許可證

此項目採用 MIT 許可證。