iMessage本地MCP服务器

一个为macOS Messages提供本地MCP服务的服务器,支持搜索联系人、读取聊天记录和发送iMessage等功能。

  • by CodexLiu
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 CodexLiu/macos-imessage-mcp-server

使用说明

macOS iMessage MCP服务器

macOS消息的本地MCP服务器。

此服务器允许MCP客户端在macOS上本地访问您的消息数据。

这意味着让代理人:

  • 搜索联系人
  • 将姓名解析到聊天记录和消息发送者中
  • 列出最近的对话
  • 读取消息历史记录
  • 搜索邮件
  • 检查未读聊天记录
  • 发送iMessages

在引擎盖下,它使用:

  • Contacts.framework 用于联系人查找
  • ~/Library/Messages/chat.db 用于阅读聊天和消息
  • 通过消息应用程序发送的AppleScript

快速启动

  1. 打开“消息”应用程序,确保您已登录。
  2. 打开 System Settings > Privacy & Security > Full Disk Access 并为运行此MCP服务器的应用程序启用它。
  3. 打开 System Settings > Privacy & Security > Contacts 并为运行此MCP服务器的应用程序启用联系人访问。
  4. 如果macOS在发送时提示自动权限,请允许主机应用程序进行控制 Messages.
  5. 更改权限后完全退出并重新打开主机应用程序。
  6. 安装并构建服务器:
npm install
npm run build
  1. 配置MCP主机以运行:
node /absolute/path/to/build/index.js

之后,MCP客户端应该能够从这台Mac读取聊天记录、解析联系人和发送iMessage。