Apple Notes MCP Server

📝 Apple Notes MCP 服务器

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

🎯 功能

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

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

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

🛠️ 使用方法

可用工具

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. 快速记笔记

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

2.信息检索

在需要时搜索特定注释：

3.内容审核

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

⚡ 获得最佳效果的秘诀

• 确保您的 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 用户打造