imessage-query-fastmcp-mcp-server

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+

📦 Dependencias

Instalar todas las dependencias necesarias:

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:

📦 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:

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:

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.