Mac Messages MCP 服务器

通过 Mac Messages MCP 服务器将您的 iMessage 数据库与 AI 连接，为 FlowHunt 实现消息工作流自动化。

AI MCP Server iMessage macOS

“Mac Messages” MCP 服务器的作用是什么？

Mac Messages MCP 服务器是一款用于安全连接您在 macOS 上的 iMessage 数据库的 MCP（模型上下文协议）服务器。它使 AI 助手和大语言模型能够查询、分析并交互 iMessage 对话，为对话式 AI 和您个人或企业消息历史之间搭建桥梁。该服务器功能包括强大的手机号验证、附件处理、联系人管理、群聊管理，并支持消息的发送与接收。开发者可借助这些功能构建高级工作流、自动化基于消息的任务，或挖掘丰富的消息数据以增强生产力工具及其他 AI 应用。

提示模板列表

仓库或文档未明确提及任何提示模板。

资源列表

仓库中未记录任何明确的 MCP 资源（即 MCP: 为 LLM 上下文暴露的数据/内容）。

工具列表

仓库或 server.py 文件未明确列出任何工具。仓库中提及了如查询 iMessage 对话、手机号验证、附件处理、联系人管理、群聊处理和消息收发等功能，这些可能作为工具开放，但在可用文档中并未被具体列为 MCP 工具。

此 MCP 服务器的应用场景

iMessage 数据库查询
允许 AI 助手搜索和分析历史 iMessage 对话，更易查找特定信息、趋势或沟通模式。
附件与媒体处理
支持提取和处理消息附件（如图片、文件），便于 AI 模型后续处理或摘要。
联系人与群聊分析
可组织、管理和查询联系人及群聊，支持更丰富的上下文感知助手功能。
自动化消息工作流
支持以编程方式发送与接收 iMessage，实现通知机器人、提醒或通过 AI 自动化工作流。
手机号验证与标准化
与联系人交互时，保证手机号规范和验证，提高沟通流程的准确性与减少错误。

如何设置

Windsurf

确保您的系统已安装 Python 和 Node.js。
找到 Windsurf 配置文件（一般为 windsurf.config.json）。

在 mcpServers 区块添加如下 JSON 片段以接入 Mac Messages MCP 服务器：

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

保存配置文件并重启 Windsurf。
通过 Windsurf 仪表盘确认 MCP 服务器已连接并可用。

Claude

确保已安装 Python 和 Node.js。
打开 Claude 的配置界面。

在 MCP servers 部分添加 Mac Messages MCP 服务器：

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

保存并重启 Claude。
确认 MCP 服务器已连接。

Cursor

如未安装，请先安装 Python 和 Node.js。
打开 Cursor 应用设置或配置文件。

在 MCP servers 配置下插入以下内容：

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

保存更改并重启 Cursor。
检查服务器是否可用并已运行。

Cline

确保已安装 Python 和 Node.js。
访问您的 Cline 配置文件。

添加 MCP 服务器配置：

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

保存并重启 Cline。
验证 Mac Messages MCP 服务器已连接。

保护 API 密钥

为保护敏感密钥或令牌，请使用环境变量。在配置中如下引用：

{
  "mac-messages-mcp": {
    "command": "mac-messages-mcp",
    "args": [],
    "env": {
      "IMESSAGE_DB_PATH": "/Users/youruser/Library/Messages/chat.db"
    },
    "inputs": {
      "api_key": "${IMESSAGE_API_KEY}"
    }
  }
}

请将 IMESSAGE_DB_PATH 和 IMESSAGE_API_KEY 替换为您的实际环境变量名。

如何在流程中使用此 MCP

在 FlowHunt 中使用 MCP

要将 MCP 服务器集成到 FlowHunt 工作流中，请先将 MCP 组件添加到您的流程，并与 AI 代理连接：

点击 MCP 组件打开配置面板。在系统 MCP 配置部分，使用如下 JSON 格式填入您的 MCP 服务器信息：

{
  "mac-messages-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 代理即可作为工具访问该 MCP 的全部功能和能力。请记得将 "mac-messages-mcp" 替换为您的实际 MCP 服务器名称，并将 URL 换成您自己的 MCP 服务器地址。

总览

部分	可用性	详情/备注
总览	✅	包含高层摘要
提示模板列表	⛔	未记录任何提示模板
资源列表	⛔	未列出任何明确的 MCP 资源
工具列表	⛔	未明确列出 MCP 工具，仅描述功能
API 密钥安全	✅	提供了基于环境变量的示例
采样支持（评估时可不重要）	⛔	文档中未提及