mac_messages_mcp
by carterlasalle·★ 284·综合分 52
一个Python MCP服务器,连接macOS Messages应用与LLM,安全地查询和分析iMessage对话。
概述
mac_messages_mcp通过MCP协议全面访问macOS Messages数据库。它具有智能消息发送功能,可根据收件人能力自动在iMessage和SMS/RCS之间路由,支持通过联系人和群聊进行高级消息过滤,模糊搜索功能,以及渐进式附件处理以高效管理媒体文件。该服务器实现了强大的安全性,妥善处理macOS权限,并为Claude Desktop、Cursor和Docker环境提供了广泛的集成选项。
试试问 AI
装完之后,这里有 5 个你可以让 AI 做的事:
什么时候选它
当您需要将 macOS 消息功能集成到 AI 工作流中,特别是如果您同时使用 iMessage 和 Android 联系人时,选择此 MCP 服务器。
什么时候不要选它
如果您需要跨平台消息管理而不仅仅是 macOS,请不要选择它,因为它仅限于 Apple 的 Messages 应用数据库。
此 server 暴露的工具
从 README 抽取出 8 个工具tool_get_recent_messagesReads recent messages from the macOS Messages app
tool_fuzzy_search_messagesSearches through message content with intelligent matching
tool_send_messageSends a message via iMessage or SMS/RCS based on recipient availability
tool_find_contactFinds contacts and returns phone numbers in E.164 format
tool_get_chatsRetrieves list of chats for filtering conversations
tool_check_imessage_availabilityChecks if a recipient has iMessage before sending
tool_search_attachmentsSearches for attachments by date, contact, and MIME type
tool_get_attachmentRetrieves an attachment file by its ID
可对比工具
安装
安装
先决条件
- macOS(已在macOS 11+上测试)
- Python 3.10+
- uv包管理器
快速安装
uv pip install mac-messages-mcpClaude Desktop集成
添加到claude_desktop_config.json:
{
"mcpServers": {
"messages": {
"command": "uvx",
"args": [
"mac-messages-mcp"
]
}
}
}完全磁盘访问权限
⚠️ 此应用程序需要终端或应用程序具有**完全磁盘访问**权限才能访问Messages数据库。
授予权限:
- 打开**系统偏好设置/设置** > **安全性与隐私/隐私** > **完全磁盘访问**
- 点击锁图标进行更改
- 将您的终端应用程序(Terminal、iTerm2等)或Claude Desktop/Cursor添加到列表中
- 授予权限后重新启动终端或应用程序
FAQ
- 这个工具是否适用于Android用户?
- 是的,当与没有iMessage的Android用户通信时,服务器会自动回退到SMS/RCS。
- 附件是如何处理的?
- 服务器使用渐进式披露机制 - 通过消息搜索发现附件成本低廉,而获取附件则是按需进行的,支持各种MIME类型,并对图像有特殊处理(HEIC转换为PNG)。
mac_messages_mcp 对比
最后更新于 · 由 README + GitHub 公开数据自动生成。