笔记索引服务

Apple Notes MCP 服务器

[!警告]
这个项目仍被视为处于开发阶段（预阿尔法版）。数据架构未来可能会有所变动。请谨慎使用——更新后可能需要重新索引您的笔记。

安装

bun install

使用方法

1. 打开Claude桌面版
2. 设置 > 开发者 > 编辑配置
3. 开放 claude_desktop_config.json 并添加以下条目：

{
  "mcpServers": {
    "Apple Notes": {
      "command": "/Users/<YOUR_USER_NAME>/.bun/bin/bun",
      "args": ["<PATH_TO_REPO>/mcp-apple-notes/src/index.ts"]
    }
  }
}

或者， bun run scripts/print-mcp-config.ts 在终端中获取输出结果。

4. 退出并重新启动Claude桌面版。在“搜索和工具”下，你应该能看到“Apple Notes”。

5. 提示Claude为你的笔记建立索引并提供一个文件夹：“在文件夹____中为我的Apple Notes建立索引”。如果你没有提供文件夹，它可能会在主“笔记”文件夹中建立索引。

发展

对于与助手进行的交互式调试 MCP检查员：

bun run dev

检查员用（某种材料或工具）包裹住服务器 @modelcontextprotocol/inspector这为你提供了一个本地网页用户界面来测试这些工具。

数据存储与维护

• LanceDB 表存储在 ~/.mcp-apple-notes/data.

• 重新运行 index_notes 在你更新笔记后，确保嵌入表示和文本保持最新。

• 要重新开始，请清除数据库：

  复制

  bun run purge-db
  

  该命令移除了 ~/.mcp-apple-notes 目录；之后重新索引。

致谢/鸣谢

• 这个项目是基于并改编自 RafalWilinski/mcp-apple-notes（可译为“RafalWilinski的苹果笔记应用”或根据具体上下文调整为更贴切的表述）。