A
security-
licenseA
qualityEnables interaction with Apple Notes via natural language, supporting note creation, search, and retrieval with iCloud integration for seamless note management.
Last updated -
3
11
MIT License
MCP 苹果笔记
模型上下文协议 (MCP)服务器，支持对你的 Apple Notes 进行语义搜索和 RAG（检索增强生成）。这使得像 Claude 这样的 AI 助手能够在对话过程中搜索和参考你的 Apple Notes。
特征
🔍 使用
all-MiniLM-L6-v2设备嵌入模型对 Apple Notes 进行语义搜索📝 全文搜索功能
📊 使用LanceDB进行向量存储
🤖 MCP 兼容服务器，用于 AI 助手集成
🍎 通过 JXA 集成原生 Apple Notes
🏃♂️ 完全本地执行 - 无需 API 密钥
先决条件
安装
克隆存储库：
git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes
安装依赖项：
bun install
用法
打开 Claude 桌面应用程序并转到“设置”->“开发者”->“编辑配置”
打开
claude_desktop_config.json并添加以下条目：
{
"mcpServers": {
"local-machine": {
"command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
"args": ["/Users/<YOUR_USER_NAME>/apple-notes-mcp/index.ts"]
}
}
}
重要提示：请将<YOUR_USER_NAME>替换为您的实际用户名。
重启 Claude 桌面应用。你应该会看到如下内容：
首先为你的笔记编制索引。让 Claude 为你的笔记编制索引，例如说“为我的笔记编制索引”或“为我的 Apple Notes 编制索引”。
故障排除
查看日志：
tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
# or
tail -n 50 -f ~/Library/Logs/Claude/mcp.log
待办事项
[ ] Apple 笔记以 HTML 格式返回。我们应该将其转换为 Markdown 格式并嵌入
[ ] 使用递归文本分割器或 Markdown 文本分割器对源内容进行分块
[ ] 添加使用自定义嵌入模型的选项
[ ] 更好地控制数据库 - 清除、自定义查询等。
[x] 通过 Claude 在 Notes 中存储笔记
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
在您的 Apple Notes 上启用语义搜索和 RAG（检索增强生成）。
Related MCP Servers
- -security-license-qualityA Model Context Protocol server that enables semantic search and retrieval of Apple Notes content, allowing AI assistants to access, search, and create notes using on-device embeddings.Last updated -2
- -security-license-qualityProvides RAG capabilities for semantic document search using Qdrant vector database and Ollama/OpenAI embeddings, allowing users to add, search, list, and delete documentation with metadata support.Last updated -416Apache 2.0
- -security-license-qualityA Model Context Protocol server that enables semantic search and RAG over your Apple Notes, allowing AI assistants like Claude to search and reference your notes during conversations.Last updated -8
Appeared in Searches
- Tools for Automatically Indexing Code Files and RAG (Retrieval-Augmented Generation)
- A vector database for efficient similarity search and AI applications
- A knowledge base for storing and accessing information
- A tool or method for searching within PDF files
- A system for managing personal knowledge and organizing information