carterlasalle/mac_messages_mcp
An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages.
解决的问题
Mac Messages MCP 允许 AI 代理程序(通过 Model Context Protocol)与 macOS Messages 应用程序交互。它使 LLM 能够读取、搜索和发送 iMessage、SMS 和 RCS 消息,以及管理联系人,所有操作皆在用户的 Mac 上本地执行。
运作原理
该服务器以只读模式连接到本地 macOS 的 chat.db 和 AddressBook 数据库,以检索消息历史记录和联系人详细信息。若要发送消息,它会使用 AppleScript 来自动化 Messages.app。它实现了一个结构边界,将消息衍生的文本标记为“不受信任”,以防止 AI 模型将外部消息内容误解为系统指令。
适用对象
希望其 AI 助理具备管理 macOS 通讯能力的 MCP 兼容客户端(例如 Claude Desktop、Cursor、VS Code 或 Codex)用户。
特色亮点
- 全面的消息功能:支持读取近期消息、对消息内容进行模糊搜索,以及列出 1:1 和群组对话。
- 附件处理:可以搜索附件元数据和内容(文本/PDF),并返回图片(将 HEIC 转换为 PNG)或较大文件的本地路径。
- 发送能力:发送消息时支持 SMS/RCS 回退,并支持排程消息以便稍后发送(需保持服务器处理程序运行)。
- 联系人管理:包含模糊联系人查询以及创建新联系人条目的功能。
- 安全优先设计:使用只读数据库访问和输出结构中立化,以减轻来自外部消息的提示注入风险。
相关
- 项目
- 项目
- 项目
- 项目
- 项目