Mensajes de Mac MCP

Un puente de Python para interactuar con la aplicación Mensajes de macOS usando MCP (Protocolo de contexto múltiple).

Características

• Leer mensajes recientes desde la aplicación Mensajes de macOS

• Filtrar mensajes por contacto

• Enviar mensajes nuevos a través de iMessage

• Acceder a los mensajes a través de una API

Related MCP server: MCP Python Server

Prerrequisitos

• macOS (probado en macOS 11+)

• Python 3.10+

• administrador de paquetes uv

Instalación de uv

Si estás en Mac, instala uv usando Homebrew:

brew install uv

De lo contrario, siga las instrucciones de instalación en el sitio web de uv .

⚠️ No proceda antes de instalar uv

Instalación

Permiso de acceso completo al disco

⚠️ Esta aplicación requiere permiso de acceso completo al disco para que su terminal o aplicación acceda a la base de datos de mensajes.

Para conceder acceso completo al disco:

1. Abra Preferencias del Sistema/Configuración > Seguridad y privacidad/Privacidad > Acceso completo al disco

2. Haga clic en el icono del candado para realizar cambios

3. Agregue su aplicación de terminal (Terminal, iTerm2, etc.) o Claude Desktop/Cursor a la lista

4. Reinicie su terminal o aplicación después de otorgar el permiso

Integración

Integración de escritorio de Claude

1. Vaya a Claude > Configuración > Desarrollador > Editar configuración > claude_desktop_config.json

2. Agregue la siguiente configuración:

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

Integración del cursor

Vaya a Configuración del cursor > MCP y pegue esto como comando:

uvx mac-messages-mcp

⚠️ Solo ejecute una instancia del servidor MCP (ya sea en Cursor o Claude Desktop), no en ambos

Opción 1: Instalar desde PyPI

uv pip install mac-messages-mcp

Opción 2: Instalar desde la fuente

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

# Install dependencies
uv install -e .

Uso

Como módulo

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)

Como herramienta de línea de comandos

# Run the MCP server directly
mac-messages-mcp

Desarrollo

Control de versiones

Este proyecto utiliza control de versiones semántico. Consulte VERSIONING.md para obtener más información sobre el funcionamiento del sistema de control de versiones y cómo publicar nuevas versiones.

Para subir la versión:

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

Notas de seguridad

Esta aplicación accede directamente a la base de datos de Mensajes, que contiene comunicaciones personales. Úsela con responsabilidad y asegúrese de tener los permisos adecuados.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Historia de las estrellas