📝 Apple Notes MCP Server

注意

未积极维护。使用风险自负！

📝 Apple Notes MCP 服务

Apple Notes MCP 服务是一个 Model Context Protocol 服务，支持通过自然语言与 Apple Notes 无缝交互。使用 Claude 或其他 AI 助手轻松创建、搜索和获取备忘录！🎉

🎯 功能

• 创建备忘录： 快速创建带有标题、内容和标签的新备忘录 📝
• 搜索备忘录： 使用强大的搜索功能查找备忘录 🔍
• 获取内容： 通过标题获取任意备忘录的完整内容 📖
• iCloud 集成： 直接与你的 iCloud 备忘录账户配合使用 ☁️

🚀 快速开始

前提条件

1. 已配置 Apple Notes 应用的 macOS
2. Node.js（版本 20.0.0 或更高）
3. Yarn 包管理器

安装

1. 克隆仓库：

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

2. 安装依赖：

   yarn install
   

3. 构建项目：

   yarn build
   

4. 启动服务：

   yarn start
   

5. 配置 Claude Desktop。使用以下内容更新你的 claude_desktop_config.json：

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

   注意： 将 /path/to/mcp-apple-notes 替换为你克隆仓库的实际路径。 首次运行命令时，你可能需要授权脚本访问 Apple Notes。

MCP 服务初始化

当服务成功启动时，你将看到：

Starting Apple Notes MCP server.

服务现在已准备好处理你的备忘录操作！🎉

🛠️ 使用方法

可用工具

1. 创建备忘录

   • 描述：在 Apple Notes 中创建一条新备忘录
   • 参数：

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

   • 示例响应：

     Note created: My New Note
     

2. 搜索备忘录

   • 描述：按标题搜索备忘录
   • 参数：

     {
       query: string; // The search query
     }
     

   • 示例响应：

     Meeting Notes
     Shopping List
     Ideas for Project
     

3. 获取备忘录内容

   • 描述：获取特定备忘录的完整内容
   • 参数：

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

   • 示例响应：

     [Full content of the note]
     

📚 示例用例

1. 快速记录

在会议或头脑风暴期间创建备忘录：

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

2. 信息检索

在需要时搜索特定备忘录：

{
"query": "meeting"
}

3. 内容查看

获取特定备忘录的完整内容：

{
"title": "Team Meeting Notes"
}

⚡ 获得最佳效果的提示

• 确保你的 Apple Notes 应用已正确配置 iCloud
• 使用描述性标题以便更好地搜索
• 创建备忘录时添加相关标签以便更好地整理

🔧 开发

该项目使用 TypeScript 并遵循现代 ES 模块模式。关键文件：

• src/index.ts：主服务实现
• src/services/appleNotesManager.ts：核心备忘录管理功能
• src/utils/applescript.ts：AppleScript 集成工具

开发容器

为 VS Code 用户提供了开发容器配置，包含：

• TypeScript Node.js 环境
• 用于代码格式化的 Prettier
• 自动安装依赖

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

---

用 ❤️ 为 Apple Notes 用户打造