MCP Apple Notes

Realiza búsqueda semántica y generación aumentada por recuperación sobre tus Notas de Apple.

GitHub
10
Prueba este MCPPatrocinado

Documentación

MCP Apple Notes

MCP Apple Notes

Un servidor de Model Context Protocol (MCP) que permite búsqueda semántica y RAG (Generación Aumentada por Recuperación) sobre tus Apple Notes. Esto permite que asistentes de IA como Claude busquen y hagan referencia a tus Apple Notes durante las conversaciones.

MCP Apple Notes

Características

  • 🔍 Búsqueda semántica sobre Apple Notes usando el modelo de embeddings en el dispositivo all-MiniLM-L6-v2
  • 📝 Capacidades de búsqueda de texto completo
  • 📊 Almacenamiento vectorial usando LanceDB
  • 🤖 Servidor compatible con MCP para integración con asistentes de IA
  • 🍎 Integración nativa con Apple Notes mediante JXA
  • 🏃♂️ Ejecución completamente local: no se necesitan claves API

Requisitos previos

Instalación

  1. Clona el repositorio:
git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes
  1. Instala las dependencias:
bun install

Uso

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

Claude Desktop Settings

  1. Abre el claude_desktop_config.json y agrega 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: Reemplaza <YOUR_USER_NAME> con tu nombre de usuario real.

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

Claude MCP Connection Status

  1. Comienza indexando tus notas. Pídele a Claude que indexe tus notas diciendo algo como: "Indexa mis notas" o "Indexa mis Apple Notes".

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

Tareas pendientes

  • Las Apple Notes se devuelven en formato HTML. Deberíamos convertirlas a Markdown e incrustarlas
  • Dividir el contenido fuente usando un divisor de texto recursivo o un divisor de texto Markdown
  • Agregar una opción para usar un modelo de embeddings personalizado
  • Más control sobre la base de datos: purga, consultas personalizadas, etc.
  • Almacenar notas en Notes mediante Claude