AI导哈

Apple Notes MCP服务

Apple Notes MCP Server是一个模型上下文协议服务器，支持通过自然语言与Apple Notes无缝交互，实现创建、搜索和检索笔记的功能。

  • by Siddhant-K-code
  • TypeScript
  • 本地部署
  • 25 星标
  • 更新于
在 GitHub 查看 Siddhant-K-code/mcp-apple-notes

使用说明

[！小心] 没有积极维护。使用风险自负！

📝 Apple Notes MCP服务器

Apple Notes MCP服务器 是一个模型上下文协议服务器，可以通过自然语言与Apple Notes进行无缝交互。使用Claude或其他人工智能助手轻松创建、搜索和检索笔记！ 🎉

🎯 特性

  • 创建笔记： 快速创建带有标题、内容和标签的新笔记📝
  • 搜索备注： 使用强大的搜索功能查找笔记🔍
  • 检索内容： 按标题获取任何笔记的全部内容📖
  • iCloud集成： 直接与您的iCloud Notes帐户配合使用☁️

🚀 入门指南

先决条件

  1. 已配置Apple Notes应用程序的macOS
  2. Node.js（20.0.0或更高版本）
  3. 纱线包装经理

安装

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

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

{
"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环境
  • 代码格式化的预处理
  • 自动依赖项安装

📄 许可证

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

由...制作❤️ 适用于Apple Notes用户

相关 MCP