用途：面向用户自己的 Apple Notes 做查找、回忆、关联发现与观点综述。典型请求包括“在我的笔记里搜索 X”“我写过关于 X 的什么”“找出笔记间的隐藏联系”“总结我在笔记里对 X 的看法”。不适用于创建提醒或非 Apple Notes 的笔记系统。
主要能力：search-notes 做混合语义加 BM25 重排检索，支持 folder、modifiedAfter、modifiedBefore；find-notes 做精确子串匹配；get-note 模糊取单条；list-notes、list-folders、list-tags、search-by-tag 做浏览与标签查询；related-notes 依据共享标签、[[wikilinks]] 与向量相似度找相关笔记；bridge-notes 用 Swanson-ABC 找非显而易见的桥梁连接；feed 输出以证据为先的连接流 JSON；entity-notes 与 list-entities 按提及权重查实体；get-tables 提取表格；create-note、update-note 创建或编辑；check-changes、index-health 检查索引状态。生成式综述由本地 Web 端点 GET /api/synthesize?q= 提供，带 [n] 引用。嵌入、搜索、BM25、聚类、桥接、实体均在本地运行，仅综述生成需要 LLM。
使用方式：先完成一次性配置。安装 bun：brew install oven-sh/bun/bun；克隆并安装依赖：git clone https://github.com/connerkward/mcp-apple-notes 后 cd mcp-apple-notes、git checkout <reviewed-tag-or-commit>、bun install。用 which bun 获取路径，在系统设置 → 隐私与安全性 → 完全磁盘访问权限中添加该 bun 二进制路径，否则无法读取 NoteStore.sqlite。注册 MCP：Claude Code 用 claude mcp add apple-notes -- bun /absolute/path/to/mcp-apple-notes/index.ts --stdio；Claude Desktop 写入 claude_desktop_config.json 的 mcpServers。也可作为插件：/plugin marketplace add connerkward/ckw-skills 后 /plugin install apple-notes@connerkward。重启客户端后先执行 index-notes 建立索引。
限制：仅支持 macOS 与 Apple Notes，不搜索 Obsidian、Notion、Google Docs 等；需本地文件系统权限，无法纯远程完成配置；搜索质量依赖最新索引，刚编辑的笔记可能有延迟；实体工具依赖可选的 layered graph db（~/.mcp-apple-notes/layered_graph.db），缺失时需改用其他工具；综述需配置 LLM，本地可用 LM Studio/Ollama（SYNTH_BASE_URL、SYNTH_MODEL、OPENAI_API_KEY），云可用 OpenAI。