Notas de Apple MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite la búsqueda semántica y RAG (Recuperación y Generación Aumentada) en tus Notas de Apple. Esto permite que asistentes de IA como Claude busquen y consulten tus Notas de Apple durante las conversaciones.

Características

• 🔍 Búsqueda semántica en Apple Notes utilizando el modelo de incrustaciones en el dispositivo all-MiniLM-L6-v2

• 📝 Capacidades de búsqueda de texto completo

• Almacenamiento vectorial mediante LanceDB

• Servidor compatible con MCP para la integración del asistente de IA

• Integración nativa de Apple Notes mediante JXA

• 🏃‍♂️ Ejecución totalmente local: no se necesitan claves API

Related MCP server: Bear Notes MCP Server with RAG

Prerrequisitos

• Bollo

• Escritorio de Claude

Instalación

1. Clonar el repositorio:

git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes

2. Instalar dependencias:

bun install

Uso

1. Abra la aplicación de escritorio de Claude y vaya a Configuración -> Desarrollador -> Editar configuración

2. Abra claude_desktop_config.json y agregue la siguiente entrada:

{
  "mcpServers": {
    "local-machine": {
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
      "args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
    }
  }
}

Importante: Reemplace <YOUR_USER_NAME> con su nombre de usuario real.

3. Reinicia la aplicación de escritorio de Claude. Deberías ver esto:

4. Empieza por indexar tus notas. Pídele a Claude que indexe tus notas diciendo algo como: "Indexar mis notas" o "Indexar mis notas de Apple".

Solución de problemas

Para ver los registros:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
# or
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

Todos

• [ ] Las notas de Apple se devuelven en formato HTML. Deberíamos convertirlas a Markdown e integrarlas.

• [ ] Divida el contenido de origen mediante un divisor de texto recursivo o un divisor de texto de rebajas

• [ ] Agregar una opción para usar un modelo de incrustaciones personalizado

• [ ] Más control sobre la base de datos: purga, consultas personalizadas, etc.

• [x] Almacenamiento de notas en Notas a través de Claude