iMCP

iMCP es una aplicación para macOS que conecta tu vida digital con la IA. Funciona con Claude Desktop y una lista creciente de clientes compatibles con el Protocolo de Contexto de Modelo (MCP) .

Capacidades

[!TIP] ¿Tiene alguna sugerencia para una nueva función? Contáctenos en imcp@loopwork.com

Empezando

Descargue y abra la aplicación

Primero, descargue la aplicación iMCP (requiere macOS 15.3 o posterior).

Cuando abras la aplicación, verás un ícono en la barra de menú.

Al hacer clic en este icono, se abre el menú de iMCP, que muestra todos los servicios disponibles. Inicialmente, todos los servicios aparecerán en gris, lo que indica que están inactivos.

El interruptor azul en la parte superior indica que el servidor MCP está ejecutándose y listo para conectarse con clientes compatibles con MCP.

Activar servicios

Para activar un servicio, haga clic en su icono. El sistema le solicitará permiso. Por ejemplo, al activar el acceso al Calendario, verá un cuadro de diálogo que pregunta "iMCP" Would Like Full Access to Your Calendar . Haga clic en «Permitir acceso completo» para continuar.

[!IMPORTANTE] iMCP no recopila ni almacena sus datos. Clientes como Claude Desktop envían sus datos fuera del dispositivo como parte de las llamadas a herramientas.

Una vez activado, los íconos de cada servicio pasan de gris a sus colores distintivos: rojo para Calendario, verde para Mensajes, azul para Ubicación, etc.

Repita este proceso para todas las funciones que desee habilitar. Estos permisos siguen el modelo de seguridad estándar de Apple, lo que le brinda control total sobre la información a la que iMCP puede acceder.

Conectarse a Claude Desktop

Si no tienes instalado Claude Desktop, puedes descargarlo aquí .

Abra Claude Desktop y vaya a "Configuración..." (⌘,)". Haga clic en "Desarrollador" en la barra lateral del panel de Configuración y luego en "Editar configuración". Esto creará un archivo de configuración en ~/Library/Application Support/Claude/claude_desktop_config.json .

Para conectar iMCP a Claude Desktop, haga clic en > "Configurar Claude Desktop".

Esto agregará o actualizará la configuración del servidor MCP para usar el ejecutable imcp-server incluido en la aplicación. Se conservarán las demás configuraciones del servidor MCP del archivo.

Haz clic en "Copiar comando del servidor al portapapeles". A continuación, abre claude_desktop_config.json en tu editor e introduce lo siguiente:

Llamar a las herramientas iMCP desde Claude Desktop

Salga y vuelva a abrir la aplicación Claude Desktop. Se le pedirá que apruebe la conexión.

[!NOTA] Es posible que vea este cuadro de diálogo dos veces; haga clic en aprobar ambas veces.

Tras aprobar la conexión, deberías ver 🔨12 en la esquina inferior derecha del chat. Haz clic ahí para ver una lista de todas las herramientas que iMCP pone a disposición de Claude.

Ahora puedes hacerle a Claude preguntas que requieran acceso a tus datos personales, como:

"¿Cómo está el clima donde estoy?"

Claude utilizará las herramientas adecuadas para recuperar esta información, proporcionándole respuestas precisas y personalizadas sin necesidad de que usted comparta manualmente estos datos durante su conversación.

Detalles técnicos

Aplicación y CLI

iMCP es una aplicación macOS que incluye un ejecutable de línea de comandos, imcp-server .

• iMCP.app proporciona una interfaz de usuario para configurar servicios y, lo más importante, un medio para interactuar con los permisos del sistema macOS, para que pueda acceder a Contactos, Calendario y otra información.
• imcp-server proporciona un servidor MCP que utiliza entrada/salida estándar para la comunicación ( transporte stdio ).

La aplicación y la CLI se comunican entre sí en la red local mediante Bonjour para el descubrimiento automático. Ambas anuncian un servicio con el tipo "_mcp._tcp" y el dominio "local". La CLI lee las solicitudes de los clientes MCP desde stdin y las retransmite a la aplicación; la CLI recibe las respuestas de la aplicación y las escribe en stdout . Consulte StdioProxy para obtener más información sobre la implementación.

Para este proyecto, creamos mcp-swift-sdk : un SDK de Swift para servidores y clientes del Protocolo de Contexto de Modelo. La aplicación utiliza este paquete para gestionar las solicitudes proxy de los clientes MCP.

Acceso a la base de datos de iMessage

Apple no proporciona API públicas para acceder a tus mensajes. Sin embargo, la app Mensajes de macOS almacena datos en una base de datos SQLite ubicada en ~/Library/Messages/chat.db .

iMCP se ejecuta en el entorno de pruebas de la aplicación , lo que limita su acceso a los datos del usuario y a los recursos del sistema. Al habilitar el servicio de Mensajes, se le pedirá que abra el archivo chat.db mediante el selector de archivos estándar. Al hacerlo, macOS añade ese archivo al entorno de pruebas de la aplicación. NSOpenPanel es así de mágico.

Pero abrir la base de datos de iMessage es solo la mitad del camino. En los últimos años, Apple ha dejado de almacenar mensajes en texto plano y ha optado por un formato propietario typedstream .

Para este proyecto, creamos Madrid : un paquete Swift para leer la base de datos de iMessage. Incluye una implementación de Swift para decodificar el formato typedstream de Apple, adaptada del proyecto iMessage-exporter de Christopher Sardegna y una entrada de blog sobre ingeniería inversa typedstream .

JSON-LD para resultados de herramientas

Las herramientas proporcionadas por iMCP devuelven resultados como documentos JSON-LD . Por ejemplo, la herramienta fetchContacts utiliza el marco de contactos , que representa a personas y organizaciones con el tipo CNContact . Así es como se codifica un objeto de ese tipo como JSON-LD:

Schema.org proporciona vocabularios estándar para personas, direcciones postales, eventos y muchos otros objetos que queremos representar. JSON-LD es un formato de codificación práctico tanto para humanos como para IA y software convencional.

Para este proyecto, creamos Ontology : un paquete Swift para trabajar con datos estructurados. Incluye inicializadores de conveniencia para tipos de frameworks de Apple, como los que devuelven las herramientas iMCP.

Depuración

Uso del inspector MCP

Para depurar las interacciones entre iMCP y los clientes, puede utilizar la herramienta de inspección (requiere Node.js):

1. Haga clic en > "Copiar comando del servidor al portapapeles"
2. Abra una terminal y ejecute los siguientes comandos:
   # Download and run inspector package on imcp-server npx @modelcontextprotocol/inspector [paste-copied-command] # Open inspector web app running locally open http://127.0.0.1:6274

Esta herramienta le permite ver todas las solicitudes y respuestas entre el cliente y el servidor iMCP, lo que es útil para comprender cómo funciona el protocolo.

Expresiones de gratitud

• Justin Spahr-Summers ( @jspahrsummers ), David Soria Parra ( @dsp-ant ) y Ashwin Bhat ( @ashwin-ant ) por su trabajo en MCP.
• Christopher Sardegna ( @ReagentX ) por realizar ingeniería inversa del formato typedstream utilizado por la aplicación Mensajes.

Licencia

Este proyecto está licenciado bajo la licencia Apache, versión 2.0.

Legal

iMessage® es una marca registrada de Apple Inc.
Este proyecto no está afiliado, respaldado ni patrocinado por Apple Inc.