MCP Catalogs
首页mac_messages_mcp screenshot

mac_messages_mcp

by carterlasalle·284·综合分 52

一个Python MCP服务器,连接macOS Messages应用与LLM,安全地查询和分析iMessage对话。

communicationfile-systemai-llm
42
Forks
0
活跃 Issue
本月
最近提交
2 天前
收录于

概述

mac_messages_mcp通过MCP协议全面访问macOS Messages数据库。它具有智能消息发送功能,可根据收件人能力自动在iMessage和SMS/RCS之间路由,支持通过联系人和群聊进行高级消息过滤,模糊搜索功能,以及渐进式附件处理以高效管理媒体文件。该服务器实现了强大的安全性,妥善处理macOS权限,并为Claude Desktop、Cursor和Docker环境提供了广泛的集成选项。

试试问 AI

装完之后,这里有 5 个你可以让 AI 做的事:

:自动回复消息并使用AI助手管理对话
:搜索和分析消息历史以查找特定信息或模式
:处理和组织对话中共享的附件和媒体
:这个工具是否适用于Android用户?
:附件是如何处理的?

什么时候选它

当您需要将 macOS 消息功能集成到 AI 工作流中,特别是如果您同时使用 iMessage 和 Android 联系人时,选择此 MCP 服务器。

什么时候不要选它

如果您需要跨平台消息管理而不仅仅是 macOS,请不要选择它,因为它仅限于 Apple 的 Messages 应用数据库。

此 server 暴露的工具

从 README 抽取出 8 个工具
  • tool_get_recent_messages

    Reads recent messages from the macOS Messages app

  • tool_fuzzy_search_messages

    Searches through message content with intelligent matching

  • tool_send_message

    Sends a message via iMessage or SMS/RCS based on recipient availability

  • tool_find_contact

    Finds contacts and returns phone numbers in E.164 format

  • tool_get_chats

    Retrieves list of chats for filtering conversations

  • tool_check_imessage_availability

    Checks if a recipient has iMessage before sending

  • tool_search_attachments

    Searches for attachments by date, contact, and MIME type

  • tool_get_attachment

    Retrieves an attachment file by its ID

可对比工具

whatsapp-mcpsignal-mcpslack-mcpdiscord-mcp

安装

安装

先决条件

  • macOS(已在macOS 11+上测试)
  • Python 3.10+
  • uv包管理器

快速安装

uv pip install mac-messages-mcp

Claude Desktop集成

添加到claude_desktop_config.json

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

完全磁盘访问权限

⚠️ 此应用程序需要终端或应用程序具有**完全磁盘访问**权限才能访问Messages数据库。

授予权限:

  1. 打开**系统偏好设置/设置** > **安全性与隐私/隐私** > **完全磁盘访问**
  2. 点击锁图标进行更改
  3. 将您的终端应用程序(Terminal、iTerm2等)或Claude Desktop/Cursor添加到列表中
  4. 授予权限后重新启动终端或应用程序

FAQ

这个工具是否适用于Android用户?
是的,当与没有iMessage的Android用户通信时,服务器会自动回退到SMS/RCS。
附件是如何处理的?
服务器使用渐进式披露机制 - 通过消息搜索发现附件成本低廉,而获取附件则是按需进行的,支持各种MIME类型,并对图像有特殊处理(HEIC转换为PNG)。

mac_messages_mcp 对比

GitHub →

最后更新于 · 由 README + GitHub 公开数据自动生成。