article

README

🚀 苹果笔记 MCP 服务器

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

🚀 快速开始

先决条件

已配置 Apple Notes 应用的 macOS 系统
Node.js（版本 20.0.0 或更高）
Yarn 包管理器

安装

克隆仓库：

git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git
cd mcp-apple-notes

安装依赖项：

yarn install

构建项目：

yarn build

启动服务器：

yarn start

配置 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 笔记账户连接 ☁️

💻 使用示例

基础用法

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

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

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

📚 详细文档

可用工具

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

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

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

2. 搜索笔记 - 描述：通过关键词或短语查找笔记 - 参数：

{
    query: string;
}

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

3. 检索内容 - 描述：根据标题获取笔记内容 - 参数：

{
    title: string;
}

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

🔧 技术细节

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

📄 许可证

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

结语

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

mcp-apple-notes