CM

carterlasalle/mac_messages_mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

340 stars 55 forks 质量 90 趋势 40MIT

carterlasalle/mac_messages_mcp 是一个从 https://github.com/carterlasalle/mac_messages_mcp. 导入的 MCP 服务器候选

概览

carterlasalle/mac_messages_mcp 是一个从 https://github.com/carterlasalle/mac_messages_mcp. 导入的 MCP 服务器候选

概述(AI 翻译)

从任何本地MCP客户端读取、搜索并发送macOS消息。

快速入门 ·可用工具 ·代理技能 ·命令行界面 ·安全性 ·更新日志

可以使用Claude、Codex、Cursor、VS Code或任何本地MCP客户端进行搜索、阅读和 通过macOS的消息应用发送消息。

Mac 消息 MCP 在你的 Mac 上本地运行。它会打开消息和联系人 数据库为只读,只返回客户端请求并使用的数据 Messages.app 自动化只有在客户端明确调用发送工具时才会实现。

[!重要] 此服务器仅支持macOS。读取消息需要全盘 访问。发送需要Mac登录Messages,并且需要获得访问权限 启动应用来自动化消息。

它是如何运作的

客户端读取的所有数据都来自本地的SQLite数据库,打开了 只读。所有离开机器的资料都通过 Messages.app, 在显式发送工具调用下。消息和联系人衍生文本被围栏为 返回模型途中的不可信数据。

能力

区域 Mac Messages MCP 提供的内容

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Use Claude, Codex, Cursor, VS Code, or any local MCP client to search, read, and send messages through the macOS Messages app.

Mac Messages MCP runs locally on your Mac. It opens the Messages and Contacts databases read-only, returns only the data a client asks for, and uses Messages.app automation only when the client explicitly calls the send tool.

[!IMPORTANT] This server is macOS-only. Reading messages requires Full Disk Access. Sending requires a Mac signed into Messages plus permission for the launching app to automate Messages.

How it works

flowchart LR
    A[MCP client] -->|stdio| B[mac-messages-mcp]
    B --> C{Tool call}
    C -->|read tools| D[(chat.db read-only)]
    C -->|read tools| E[(AddressBook read-only)]
    C -->|send tools| F[Messages.app]
    F --> G[Recipient]
    D --> H[Untrusted-output boundary]
    E --> H
    H --> A

Everything the client reads comes from the local SQLite databases, opened read-only. Everything that leaves the machine goes out through Messages.app, under an explicit send tool call. Message- and contact-derived text is fenced as untrusted data on the way back to the model.

Capabilities

Area What Mac Messages MCP provides
Reading Recent messages across all conversations or filtered by contact, group chat, date range, or unread state; paging with limit/offset and forward-cursor reads
Conversations Every conversation (1:1, business, and group) with kind, message and unread counts, last activity, and a blocking wait for new messages
Search Fuzzy message-body search across a time window or all history, scoped to a contact or conversation
Context Per-message service (iMessage/SMS/RCS), unread and delivery state, tapbacks, and threaded replies
Contacts Fuzzy contact lookup by approximate name, send-ready phone numbers, and contact creation
在 GitHub 查看完整 README

安装

uvx mac-messages-mcp
新手?先看 mcpskill.org 教程 →

配置

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