AI导哈

iMessage代理服务器

一个基于Python的iMessage代理服务器，支持通过AI代理读取和发送消息。

  • by aryanma
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 aryanma/imessage-mcp

使用说明

imessage mcp

macOS上iMessage的MCP服务器。通过AI代理读取和发送消息。

需求

  • macOS
  • Python 3.10+
  • 全磁盘访问（用于读取邮件）
  • Messages.app正在运行（用于发送）

设置

uv sync

授予全磁盘访问权限

  1. 系统设置 → 隐私和安全 → 全磁盘访问
  2. 添加您的终端（终端、iTerm、VS代码、光标）
  3. 重新启动终端

跑

cd src && python main.py

服务器运行于 http://127.0.0.1:8080/mcp

建筑

图层 组件 描述
传输 HTTP/MCP 通过dedalus-MCP流式传输HTTP
阅读 chat.db 直接SQL打开 ~/Library/Messages/chat.db
发送 osascript AppleScript RPC到Messages.app

工具

工具 说明
check_status 检查iMessage是否已准备就绪
read_messages 阅读消息（过滤器：chat_id、搜索、自、按时间顺序）
list_chats 列出对话
get_chat_participants 获取聊天成员
get_unread_messages 获取未读邮件
get_attachments 获取邮件的附件
download_attachment 将附件复制到本地路径
send_imessage 向电话/电子邮件发送文本
send_to_group 向群聊发送文本
send_file 将文件发送到电话/电子邮件
send_file_to_group 将文件发送到群聊
lookup_contact 按名称搜索Contacts.app
start_watching 开始查看新消息
check_new_messages 获取自上次检查以来的消息
stop_watching 别看了

MCP配置

添加到Claude桌面配置：

{
  "mcpServers": {
    "imessage": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

相关 MCP