Servidor MCP de consultas de iMessage

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: imessage-mcp

📦 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

• Requisitos del sistema

• Dependencias

• Herramientas MCP

• Empezando

• Opciones de instalación

  • Escritorio de Claude

  • Complemento Cline de VSCode

• Características de seguridad

• Documentación de desarrollo

• Variables de entorno

🛠️ 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 :

1. En VSCode, haga clic en el ícono del servidor (☰) en la barra lateral del complemento Cline

2. Haga clic en el botón "Editar configuración de MCP" (✎)

3. 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.

⚙️ Variables de entorno

No se requieren variables de entorno ya que el servidor ubica automáticamente la base de datos de iMessage en la ubicación predeterminada de macOS.