📝 Apple Notes MCP 服务器

Apple Notes MCP 服务器 是一个 Model Context Protocol 服务器，它通过自然语言实现与 Apple Notes 的无缝交互。使用 Claude 或其他 AI 助手轻松创建、搜索和检索笔记！🎉

🎯 功能

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

🚀 开始使用

前提条件

1. macOS 并配置了 Apple Notes 应用程序
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;      // 笔记的标题
       content: string;    // 笔记的内容
       tags?: string[];    // 笔记的可选标签
     }
     

   • 示例响应：

     Note created: My New Note
     

2. 搜索笔记

   • 描述：按标题搜索笔记
   • 参数：

     {
       query: string; // 搜索查询
     }
     

   • 示例响应：

     Meeting Notes
     Shopping List
     Ideas for Project
     

3. 获取笔记内容

   • 描述：检索特定笔记的完整内容
   • 参数：

     {
       title: string; // 笔记的确切标题
     }
     

   • 示例响应：

     [笔记的完整内容]
     

📚 示例用例

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 用户用心制作 ❤️