Apple Notes

[!Caution] Não mantido ativamente. Use por sua conta e risco!

📝 Servidor MCP do Apple Notes

Servidor MCP do Apple Notes é um servidor de Model Context Protocol que permite interação perfeita com o Apple Notes por meio de linguagem natural. Crie, pesquise e recupere notas sem esforço usando Claude ou outros assistentes de IA! 🎉

🎯 Recursos

• Criar Notas: Crie rapidamente novas notas com títulos, conteúdo e tags 📝
• Pesquisar Notas: Encontre notas usando recursos poderosos de pesquisa 🔍
• Recuperar Conteúdo: Obtenha o conteúdo completo de qualquer nota pelo título 📖
• Integração com iCloud: Funciona diretamente com sua conta de Notas do iCloud ☁️

🚀 Começando

Pré-requisitos

1. macOS com o aplicativo Apple Notes configurado
2. Node.js (versão 20.0.0 ou superior)
3. Gerenciador de pacotes Yarn

Instalação

1. Clone o repositório:

   git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git
   cd mcp-apple-notes
   

2. Instale as dependências:

   yarn install
   

3. Compile o projeto:

   yarn build
   

4. Inicie o servidor:

   yarn start
   

5. Configure o Claude Desktop. Atualize seu claude_desktop_config.json com:

   {
     "mcpServers": {
       "apple-notes": {
         "command": "yarn",
         "args": ["start"],
         "cwd": "/path/to/mcp-apple-notes"
       }
     }
   }
   

   Nota: Substitua /path/to/mcp-apple-notes pelo caminho real do seu repositório clonado. Talvez seja necessário autorizar o script a acessar o Apple Notes ao executar os comandos pela primeira vez.

Inicialização do Servidor MCP

Quando o servidor iniciar com sucesso, você verá:

Starting Apple Notes MCP server.

O servidor agora está pronto para lidar com suas operações de notas! 🎉

🛠️ Uso

Ferramentas Disponíveis

1. Criar Nota

   • Descrição: Cria uma nova nota no Apple Notes
   • Parâmetros:

     {
       title: string;      // The title of the note
       content: string;    // The content of the note
       tags?: string[];    // Optional tags for the note
     }
     

   • Exemplo de Resposta:

     Note created: My New Note
     

2. Pesquisar Notas

   • Descrição: Pesquisa notas por título
   • Parâmetros:

     {
       query: string; // The search query
     }
     

   • Exemplo de Resposta:

     Meeting Notes
     Shopping List
     Ideas for Project
     

3. Obter Conteúdo da Nota

   • Descrição: Recupera o conteúdo completo de uma nota específica
   • Parâmetros:

     {
       title: string; // The exact title of the note
     }
     

   • Exemplo de Resposta:

     [Full content of the note]
     

📚 Exemplos de Casos de Uso

1. Anotações Rápidas

Crie notas durante reuniões ou sessões de brainstorming:

{
"title": "Team Meeting Notes",
"content": "Discussion points:\n1. Project timeline\n2. Resource allocation",
"tags": ["meetings", "work"]
}

2. Recuperação de Informações

Pesquise notas específicas quando precisar delas:

{
"query": "meeting"
}

3. Revisão de Conteúdo

Obtenha o conteúdo completo de uma nota específica:

{
"title": "Team Meeting Notes"
}

⚡ Dicas para Melhores Resultados

• Certifique-se de que o aplicativo Apple Notes esteja configurado corretamente com o iCloud
• Use títulos descritivos para melhorar a busca
• Inclua tags relevantes ao criar notas para melhor organização

🔧 Desenvolvimento

O projeto usa TypeScript e segue padrões modernos de módulos ES. Arquivos principais:

• src/index.ts: Implementação principal do servidor
• src/services/appleNotesManager.ts: Funcionalidade principal de gerenciamento de notas
• src/utils/applescript.ts: Utilitários de integração com AppleScript

Contêiner de Desenvolvimento

Uma configuração de contêiner de desenvolvimento é fornecida para usuários do VS Code, oferecendo:

• Ambiente TypeScript Node.js
• Prettier para formatação de código
• Instalação automática de dependências

📄 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

---

Feito com ❤️ para usuários do Apple Notes