mcp-apple-notes

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables semantic search and retrieval of Apple Notes content, allowing access to notes during AI assistant conversations. Supports both full-text and semantic search capabilities using on-device embeddings.

MCP 苹果笔记

模型上下文协议 (MCP)服务器,支持对你的 Apple Notes 进行语义搜索和 RAG(检索增强生成)。这使得像 Claude 这样的 AI 助手能够在对话过程中搜索和参考你的 Apple Notes。

特征

  • 🔍 使用all-MiniLM-L6-v2设备嵌入模型对 Apple Notes 进行语义搜索
  • 📝 全文搜索功能
  • 📊 使用LanceDB进行向量存储
  • 🤖 MCP 兼容服务器,用于 AI 助手集成
  • 🍎 通过 JXA 集成原生 Apple Notes
  • 🏃‍♂️ 完全本地执行 - 无需 API 密钥

先决条件

安装

  1. 克隆存储库:
git clone https://github.com/RafalWilinski/mcp-apple-notes cd mcp-apple-notes
  1. 安装依赖项:
bun install

用法

  1. 打开 Claude 桌面应用程序并转到“设置”->“开发者”->“编辑配置”

  1. 打开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>替换为您的实际用户名。

  1. 重启 Claude 桌面应用。你应该会看到如下内容:

  1. 首先为你的笔记编制索引。让 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 中存储笔记
-
security - not tested
F
license - not found
-
quality - not tested

在您的 Apple Notes 上启用语义搜索和 RAG(检索增强生成)。

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Troubleshooting
            1. Todos
              ID: 19dbdavht0