📝 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://glama.ai/mcp/servers/ayr26szokg/badge" alt="Apple Notes Server MCP server" /> </a>

🎯 功能

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

🚀 快速开始

前提条件

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;      // 笔记的标题
       content: string;    // 笔记的内容
       tags?: string[];    // 笔记的可选标签
     }
     

   • 示例响应：

     Note created: My New Note
     

2. 搜索笔记

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

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

   • 示例响应：

     Meeting Notes
     Shopping List
     Ideas for Project
     

3. 获取笔记内容

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

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

   • 示例响应：

     [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 用户制作