Apple Notes

Converse com suas Notas do Apple

GitHub
415
Experimente este MCPPatrocinado

Documentação

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 Notas do Apple Notes. Isso permite que assistentes de IA como o Claude pesquisem e referenciem suas Notas do Apple Notes durante conversas.

MCP Apple Notes

Recursos

  • 🔍 Busca semântica sobre Notas do Apple Notes usando o modelo de embeddings on-device all-MiniLM-L6-v2
  • 📝 Recursos de busca em 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 - nenhuma chave de API necessária

Pré-requisitos

Instalação

  1. Clone o repositório:
git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes
  1. Instale as dependências:
bun install

Uso

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

Claude Desktop Settings

  1. 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.

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

Claude MCP Connection Status

  1. Comece indexando suas notas. Peça ao Claude para indexar suas notas dizendo algo como: "Indexe minhas notas" ou "Indexe minhas Notas do 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 notas do Apple 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 banco de dados - limpeza, consultas personalizadas, etc.
  • Armazenar notas no Notes via Claude