Mac Messages MCP

一个使用 MCP (多上下文协议) 与 macOS Messages 应用交互的 Python 桥梁。

功能

• 从 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. 授予权限后，重新启动您的终端或应用程序

集成

Claude Desktop 集成

1. 转到 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json
2. 添加以下配置：

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

Cursor 集成

转到 Cursor 设置 > MCP 并将以下内容粘贴为命令：

uvx mac-messages-mcp

⚠️ 仅运行 MCP 服务器的一个实例（在 Cursor 或 Claude Desktop 上），而不是两者都运行

选项 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

开发

版本控制

本项目使用语义版本控制。 有关版本控制系统的工作方式以及如何发布新版本的详细信息，请参见 VERSIONING.md。

要增加版本号：

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

安全注意事项

此应用程序直接访问 Messages 数据库，其中包含个人通信。 请负责任地使用它，并确保您具有适当的权限。

许可证

MIT

贡献

欢迎贡献！ 请随时提交 Pull Request。

<a href="https://glama.ai/mcp/servers/gxvaoc9znc"> <img width="380" height="200" src="https://glama.ai/mcp/servers/gxvaoc9znc/badge" /> </a>