📝 Apple Notes MCP 服务器

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

<a href="https://glama.ai/mcp/servers/ayr26szokg"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1460091380,2397303047&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Apple Notes Server MCP 服务器" /> </a>

🎯 特性

• 创建笔记： 快速创建带有标题、内容和标签的新笔记 📝
• 搜索笔记： 使用强大的搜索功能找到笔记 🔍
• 获取内容： 根据标题获取任何笔记的完整内容 📖
• 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 服务器初始化

当服务器成功启动时，您会看到：

正在启动 Apple Notes MCP 服务器。

现在服务器已准备好处理您的笔记操作！🎉

🛠️ 使用方法

可用工具

1. 创建笔记

   • 描述：在 Apple Notes 中创建新笔记
   • 参数：

     {
       title: string;      // 笔记的标题
       content: string;    // 笔记的内容
       tags?: string[];    // 笔记的可选标签
     }
     

   • 示例响应：

     创建了笔记：我的新笔记
     

2. 搜索笔记

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

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

   • 示例响应：

     会议记录
     购物清单
     项目想法
     

3. 获取笔记内容

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

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

   • 示例响应：

     [笔记的完整内容]
     

📚 示例用例

1. 快速笔记记录

在会议或头脑风暴期间创建笔记：

{
"title": "团队会议记录",
"content": "讨论要点：\n1. 项目时间线\n2. 资源分配",
"tags": ["会议", "工作"]
}

2. 信息检索

需要时搜索特定笔记：

{
"query": "会议"
}

3. 内容审查

获取特定笔记的完整内容：

{
"title": "团队会议记录"
}

⚡ 最佳结果提示

• 确保您的 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 用户制作