MCP Apple Notes

MCP Apple Notes

Um servidor Model Context Protocol (MCP) que permite busca semântica e RAG (Geração Aumentada por Recuperação) sobre suas Apple Notes. Isso permite que assistentes de IA como o Claude pesquisem e referenciem suas Apple Notes durante conversas.

Recursos

• 🔍 Busca semântica sobre Apple Notes usando o modelo de embeddings no dispositivo all-MiniLM-L6-v2
• 📝 Capacidades de busca de texto completo
• 📊 Armazenamento vetorial usando LanceDB
• 🤖 Servidor compatível com MCP para integração com assistentes de IA
• 🍎 Integração nativa com Apple Notes via JXA
• 🏃♂️ Execução totalmente local - sem necessidade de chaves de API

Pré-requisitos

• Bun
• Claude Desktop

Instalação

1. Clone o repositório:

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

2. Instale as dependências:

bun install

Uso

1. Abra o aplicativo de desktop do Claude e vá em Configurações -> Desenvolvedor -> Editar Config

2. Abra o claude_desktop_config.json e adicione a seguinte entrada:

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

Importante: Substitua <YOUR_USER_NAME> pelo seu nome de usuário real.

3. Reinicie o aplicativo de desktop do Claude. Você deve ver isto:

4. Comece indexando suas notas. Peça ao Claude para indexar suas notas dizendo algo como: "Indexe minhas notas" ou "Indexe minhas Apple Notes".

Solução de problemas

Para ver os logs:

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

Tarefas pendentes

• As Apple Notes são retornadas no formato HTML. Devemos convertê-las para Markdown e incorporá-las.
• Dividir o conteúdo de origem usando divisor de texto recursivo ou divisor de texto markdown
• Adicionar uma opção para usar modelo de embeddings personalizado
• Mais controle sobre o DB - limpeza, consultas personalizadas, etc.
• Armazenar notas no Notes via Claude