🚀 苹果笔记 MCP 服务器

苹果笔记 MCP 服务器是一个模型上下文协议（Model Context Protocol）服务器，它支持通过自然语言与 Apple Notes 进行无缝交互。借助该服务器，你可以使用 Claude 或其他 AI 助手快速创建、搜索和检索笔记，极大提升工作效率！🎉

🚀 快速开始

先决条件

• 已配置 Apple Notes 应用的 macOS 系统。
• Node.js（版本 20.0.0 或更高）。
• 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 服务器初始化

当服务器成功启动后，你会看到：

正在启动苹果笔记 MCP 服务器。

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

✨ 主要特性

• 创建笔记：可快速生成新笔记，支持设置标题、内容和标签 📝。
• 搜索笔记：借助强大的搜索功能查找笔记 🔍。
• 检索内容：能根据标题获取任意笔记的完整内容 📖。
• iCloud 集成：可直接与你的 iCloud 笔记账户连接 ☁️。

📦 安装指南

安装步骤如下：

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"
    }
  }
}

💻 使用示例

基础用法

快速创建笔记

# 创建新笔记
create-note --title "每日计划" --content "今天的工作安排如下：..."

信息检索

# 搜索笔记
search-notes --query "会议记录"

# 根据标题获取内容
retrieve-content --title "项目总结"

高级用法

本部分可参考前文“🛠️ 使用方法”中各工具的详细参数说明，根据实际需求灵活组合参数，实现更复杂的笔记操作。

📚 详细文档

可用工具

创建笔记

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

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

• 示例响应：正在为您的新笔记生成内容...

搜索笔记

• 描述：通过关键词或短语查找笔记。
• 参数：

{
  query: string;
}

• 示例响应：返回匹配的笔记列表。

检索内容

• 描述：根据标题获取笔记内容。
• 参数：

{
  title: string;
}

• 示例响应：返回指定标题的笔记内容。

🔧 技术细节

本项目使用 TypeScript 和 Node.js 构建，集成 AppleScript 进行底层操作。代码仓库托管于 GitHub，并提供详细的文档支持。

📄 许可证

项目遵循 MIT 许可证，具体内容请参考 LICENSE 文件。

结语

欢迎使用苹果笔记 MCP 服务器，通过自然语言与你的笔记数据无缝交互，提升工作效率！