项目介绍
MCP Apple Notes
这是一个用于Apple Notes语义搜索和检索的模型上下文协议(MCP)服务器。
特性
- 🔍 使用设备上的嵌入模型进行语义搜索
- 📝 全文搜索功能
- 💾 使用LanceDB进行向量存储
- 🍎 与Apple Notes原生集成
预备条件
- macOS(用于Apple Notes集成)
- Bun JavaScript运行时
安装
- 克隆此仓库:
git clone https://github.com/Dingzeefs/mcp-apple-notes.git
cd mcp-apple-notes
- 安装依赖项:
bun install
使用方法
在Cursor IDE中配置
-
打开Cursor IDE
-
前往设置 → 功能 → MCP
-
添加一个新的MCP服务器,并使用以下配置:
- 名称:Apple Notes
- 类型:命令
- 命令:
/path/to/bun /path/to/mcp-apple-notes/index.ts
将/path/to/bun替换为实际的Bun可执行文件路径(通过which bun找到),并将/path/to/mcp-apple-notes替换为此仓库的实际路径。
-
重启Cursor IDE
使用MCP服务器
配置完成后,您可以在与Claude的对话中使用以下工具:
- list-notes:列出所有Apple Notes标题
- index-notes:索引您的笔记以进行语义搜索(首先执行此操作)
- get-note:通过标题检索特定笔记
- search-notes:使用语义或关键词搜索您的笔记
- create-note:创建具有指定标题和内容的新笔记
故障排除
如果您遇到问题:
- 检查MCP服务器状态以确认服务器是否在Cursor中运行
- 确认MCP服务器配置中的路径正确无误
- 尝试直接在终端中运行命令以查看任何错误消息
- 确保Apple Notes可以访问并且已授予权限
许可证
MIT