AI导哈

Apple Notes自动化服务

通过Model Context Protocol (MCP)提供Apple Notes的自动化操作，包括创建、读取、更新和删除笔记等功能。

  • by henilcalagiya
  • Python
  • 本地部署
  • 53 星标
  • 更新于
在 GitHub 查看 henilcalagiya/mcp-apple-notes

使用说明

Apple Notes MCP服务器

使用模型上下文协议（MCP）自动化Apple Notes的强大工具

mcp名称：io.github.henilcalagiya/mcp-apple-notes

概述

Apple Notes MCP服务器提供Apple Notes与任何MCP兼容客户端的无缝集成。它通过一个简单安全的AppleScript API层实现了完整的笔记自动化，包括创建、阅读、更新和删除笔记。

特性

  • 完全CRUD支持 适用于Apple Notes（创建、读取、更新、删除）
  • 与Continue.dev、Claude Desktop、Perplexity和其他MCP客户端配合使用
  • 本地AppleScript集成 实现可靠的macOS自动化
  • 综合工具 用于Apple Notes自动化
  • 自动安装 通过 uvx 或手动设置
  • FastMCP实施 使用基于现代装饰器的API

需求

  • macOS -需要AppleScript支持
  • Python 3.10+ -MCP SDK兼容性所需
  • Apple Notes应用程序 -必须安装并可访问
  • MCP兼容客户端 （例如，Continue.dev、Claude Desktop）

快速开始

步骤1：安装uv（如果尚未安装）

macOS/Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows（PowerShell）：

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

备选方案（pip）：

pip install uv

步骤2：添加MCP配置

将此配置添加到MCP客户端：

对于困惑、光标、Continue.dev、克劳德桌面：

{
  "mcpServers": {
    "apple-notes": {
      "command": "uvx",
      "args": ["mcp-apple-notes@latest"]
    }
  }
}

🎉 就是这样！ 您的MCP客户端将在需要时自动安装并运行该软件包。

注： 确保您的MCP客户端有权访问Apple Notes并在“系统首选项”中执行AppleScript命令→ 安全与隐私→ 隐私→ 无障碍。

可用工具

笔记管理（6个工具）

  • create_note -使用HTML内容创建笔记
  • read_note -通过身份验证读取笔记
  • update_note -用HTML内容按ID更新笔记
  • delete_note -通过验证按ID删除笔记
  • move_note -在文件夹之间移动笔记
  • list_all_notes -列出所有文件夹中的所有笔记

文件夹管理（5个工具）

  • create_folder -创建具有路径支持的文件夹
  • read_folder -按ID读取文件夹详细信息
  • rename_folder -按ID重命名文件夹
  • delete_folder -按ID删除文件夹
  • move_folder -在不同位置之间移动文件夹

搜索和结构（3个工具）

  • search_notes -按关键字搜索笔记
  • list_folder_with_structure -显示文件夹层次结构
  • list_notes_with_structure -显示文件夹+笔记层次结构

内容支持

HTML格式: <h1-h6>, <b><i><u>, <p><div><br>, <ul><ol><li>, <table>, <a>

特别功能:

  • 支持Unicode和表情符号(🚀, ✅, 📝)
  • 嵌套文件夹路径（最多5级）
  • 自动字符转义
  • 内容丰富，有标题、列表、表格

建筑

服务器遵循MCP协议规范，采用模块化架构构建：

  • AppleScript层 -处理与Apple Notes的直接交互
  • 工具层 -包装MCP工具的AppleScript操作
  • FastMCP服务器层 -使用装饰器实现MCP协议

故障排除

常见问题

  1. “没有名为'mcp'的模块”错误

    • 使用 uvx 用于自动安装
    • 确保 uv 已安装并位于PATH中

  2. AppleScript权限被拒绝

    • 在“系统首选项”中为您的终端/MCP客户端授予权限→ 安全与隐私→ 隐私→ 无障碍

  3. 未找到笔记

    • 确保已安装并可访问Apple Notes应用程序
    • 检查注释是否存在于默认位置

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

作者

Henil C Alagiya

支持和贡献：

  • 🐛 报告问题: GitHub问题
  • 💬 问题：联系 领英
  • 🤝 贡献：欢迎拉取请求！

相关 MCP