Servidor MCP de consultas de iMessage

Name: imessage-query-fastmcp-mcp-server
Author: hannesrudolph

Un servidor MCP que proporciona acceso seguro a tu base de datos de iMessage mediante el Protocolo de Contexto de Modelo (MCP). Este servidor está desarrollado con el framework FastMCP y la biblioteca imessagedb, lo que permite a los LLM consultar y analizar conversaciones de iMessage con la validación adecuada de números de teléfono y la gestión de archivos adjuntos.

📋 Requisitos del sistema

macOS (necesario para acceder a la base de datos de iMessage)
Python 3.6+

Related MCP server: MySQL MCP Server

📦 Dependencias

Instalar todas las dependencias necesarias:

# Using pip pip install -r requirements.txt

Paquetes requeridos

fastmcp : Marco para crear servidores de Protocolo de Contexto de Modelo
imessagedb : biblioteca de Python para acceder y consultar la base de datos de mensajes de macOS
phonenumbers : Biblioteca de manejo de números de teléfono de Google para la validación y el formato adecuados de los números.

Todas las dependencias se especifican en requirements.txt para una fácil instalación.

📑 Índice de contenidos

🛠️ Herramientas MCP

El servidor expone las siguientes herramientas a los LLM:

obtener_transcripción_del_chat

Recupera el historial de mensajes de un número de teléfono específico con filtro de fecha opcional. Incluye:

Texto del mensaje y marcas de tiempo
Información del archivo adjunto (si corresponde)
Validación adecuada del número de teléfono
Filtrado de rango de fechas

🚀 Primeros pasos

Clonar el repositorio:

git clone https://github.com/hannesrudolph/imessage-query-fastmcp-mcp-server.git cd imessage-query-fastmcp-mcp-server

📦 Opciones de instalación

Puedes instalar este servidor MCP en Claude Desktop o en el plugin Cline de VSCode. Elige la opción que mejor se adapte a tus necesidades.

Opción 1: Instalar para Claude Desktop

Instalar usando FastMCP:

fastmcp install imessage-query-server.py --name "iMessage Query"

Opción 2: Instalar el complemento Cline VSCode

Para utilizar este servidor con el complemento Cline VSCode :

En VSCode, haga clic en el ícono del servidor (☰) en la barra lateral del complemento Cline
Haga clic en el botón "Editar configuración de MCP" (✎)
Agregue la siguiente configuración al archivo de configuración:

{ "imessage-query": { "command": "uv", "args": [ "run", "--with", "fastmcp", "fastmcp", "run", "/path/to/repo/imessage-query-server.py" ] } }

Reemplace /path/to/repo con la ruta completa a donde clonó este repositorio (por ejemplo, /Users/username/Projects/imessage-query-fastmcp-mcp-server )

🔒 Características de seguridad

Acceso de solo lectura a la base de datos de iMessage
Validación de números de teléfono utilizando la biblioteca de números de teléfono
Manejo seguro de archivos adjuntos con detección de archivos faltantes
Validación de rango de fechas
Supresión de la salida de progreso para respuestas JSON limpias

📚 Documentación de desarrollo

El repositorio incluye archivos de documentación para el desarrollo:

dev_docs/imessagedb-documentation.txt : contiene documentación completa sobre la estructura de la base de datos de iMessage y las capacidades de la biblioteca imessagedb.

Esta documentación sirve como contexto durante el desarrollo de funciones y se puede utilizar con LLM para ayudar en el desarrollo.