macOS信息-MCP桥接工具

@carterlasalle/mac_messages_mcp

0 Stars 490 次浏览 carterlasalle 更新于 2026-08-23

一个用于通过MCP（多上下文协议）与macOS Messages应用交互的Python桥接工具。可以使用uvx简单安装mac-messages-mcp。

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

服务介绍

Mac Messages MCP

一个使用MCP（Multiple Context Protocol）与macOS Messages应用程序交互的Python桥梁。

a-diagram-of-a-mac-computer-with-the-tex_FvvnmbaBTFeKy6F2GMlLqA_IfCBMgJARcia1WTH7FaqwA

特性

从macOS Messages应用程序中读取最近的消息
按联系人过滤消息
通过iMessage发送新消息
通过API访问消息

前提条件

macOS（测试于macOS 11+）
Python 3.10+
uv包管理器

安装uv

如果你使用的是Mac，可以通过Homebrew安装uv：

brew install uv

否则，请按照uv网站上的安装说明进行操作。

⚠️ 在安装uv之前不要继续

安装

完全磁盘访问权限

⚠️ 此应用程序需要完全磁盘访问权限，以便你的终端或应用程序能够访问Messages数据库。

要授予完全磁盘访问权限：

打开系统偏好设置/设置 > 安全性与隐私/隐私 > 完全磁盘访问
点击锁定图标以进行更改
将你的终端应用（如Terminal、iTerm2等）或Claude Desktop/Cursor添加到列表中
授予权限后重启你的终端或应用程序

集成

Claude桌面集成

转至Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json
添加以下配置：

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

Cursor集成

转至Cursor设置 > MCP并将此作为命令粘贴：

uvx mac-messages-mcp

⚠️ 只运行一个MCP服务器实例（要么在Cursor上，要么在Claude Desktop上），而不是同时运行两个

选项1：从PyPI安装

uv pip install mac-messages-mcp

选项2：从源代码安装

# Clone the repository
git clone https://github.com/carterlasalle/mac_messages_mcp.git
cd mac_messages_mcp

# Install dependencies
uv install -e .

使用

作为模块

from mac_messages_mcp import get_recent_messages, send_message

# Get recent messages
messages = get_recent_messages(hours=48)
print(messages)

# Send a message
result = send_message(recipient="+1234567890", message="Hello from Mac Messages MCP!")
print(result)

作为命令行工具

# Run the MCP server directly
mac-messages-mcp

开发

版本控制

此项目使用语义化版本控制。有关版本控制系统的工作原理以及如何发布新版本的详细信息，请参阅VERSIONING.md。

要提升版本：

python scripts/bump_version.py [patch|minor|major]

安全注意事项

此应用程序直接访问包含个人通信的Messages数据库。请负责任地使用它，并确保你有适当的权限。

许可证

MIT

贡献

欢迎贡献！请随时提交Pull Request。

查看源码项目主页