mcp-苹果笔记

作者：Siddhant-K-code12 星标更新：2025-03-12

安装使用来源：spider==github.com

项目介绍

📝 Apple Notes MCP 服务器

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

<a href="https://glama.ai/mcp/servers/ayr26szokg"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1460091380,2397303047&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Apple Notes Server MCP 服务器" /> </a>

🎯 特性

创建笔记： 快速创建带有标题、内容和标签的新笔记 📝
搜索笔记： 使用强大的搜索功能找到笔记 🔍
获取内容： 根据标题获取任何笔记的完整内容 📖
iCloud 集成： 直接与您的 iCloud 笔记账户集成 ☁️

🚀 开始使用

先决条件

已配置 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 服务器初始化

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

正在启动 Apple Notes MCP 服务器。

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

🛠️ 使用方法

可用工具

创建笔记

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

参数：

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

示例响应：
```
创建了笔记：我的新笔记
```

搜索笔记

描述：按标题搜索笔记
参数：
```
{
  query: string; // 搜索查询
}
```
示例响应：
```
会议记录
购物清单
项目想法
```

获取笔记内容
- 描述：检索特定笔记的完整内容
- 参数：
```
{
  title: string; // 笔记的确切标题
}
```
- 示例响应：
```
[笔记的完整内容]
```

📚 示例用例

1. 快速笔记记录

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

{
"title": "团队会议记录",
"content": "讨论要点：\n1. 项目时间线\n2. 资源分配",
"tags": ["会议", "工作"]
}

2. 信息检索

需要时搜索特定笔记：

{
"query": "会议"
}

3. 内容审查

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

{
"title": "团队会议记录"
}

⚡ 最佳结果提示

确保您的 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 用户制作