MCP 服务器
让 Claude 和其他智能体搜索你导出的内容。
Exporter 在应用内运行一个 MCP 服务器。它把你的导出文件夹提供给 Claude、Cursor、VS Code 和其他任何 MCP 客户端,只读,并且只在你的 Mac 上。智能体还能使用的技能和命令行,请参阅面向智能体。
启动
- 至少以 Markdown 导出一个应用(开始使用)。服务器只读取 Markdown 文件。
- 在 MCP 服务器卡片上点按“启动”。卡片随后会显示
localhost:8744和一行“连接”。
端点是 http://localhost:8744/mcp(Streamable HTTP),端口固定。服务器运行在应用中:只要 Exporter 在运行,无论窗口打开还是关闭,它都会响应,退出应用时它会停止。如果退出时它正在运行,下次它会随应用一起启动。服务器运行期间,curl -s http://127.0.0.1:8744/health 会返回 OK。
连接 Claude Code
claude mcp add --transport http exporter http://localhost:8744/mcp
加上 --scope user 即可在所有项目中使用。卡片上的“claude code”按钮会复制这条命令。
Claude Desktop、Cursor 和 VS Code
- Claude Desktop:在卡片上点按“claude desktop”。它会复制一段运行
npx -y mcp-remote http://localhost:8744/mcp的条目(npx随 Node.js 一起提供)。在“设置”>“开发者”>“编辑配置”中把它粘贴到mcpServers内,存储,然后退出 Claude 并重新打开 - Cursor 或 VS Code:在卡片上点按“cursor”或“vs code”。编辑器会打开,服务器已准备好安装;在那里确认即可
它提供哪些文件夹
与 Apple 备忘录导出文件夹位于同一个上级文件夹中的导出文件夹(如果没有 Apple 备忘录导出文件夹,则是它找到的第一个导出文件夹)。放在其他任何位置的导出文件夹对智能体都不可见,MCP 服务器卡片会显示它们能看到哪些。
| 导出文件夹 | 提供的内容 |
|---|---|
~/Documents/notes、~/Documents/messages |
两者 |
~/Documents/notes、~/Dropbox/messages |
只有 notes |
要把某个文件夹纳入,在该应用的 导出到 一行点按“更改…”,在同一个上级文件夹中选择一个文件夹,然后在那张卡片上点按“完全重新同步”。服务器在启动时读取文件夹列表,所以任何更改之后都要点按“停止”再点按“启动”。每个来源以它的文件夹命名,例如 notes 或 messages。
六个工具
| 工具 | 作用 | 参数 |
|---|---|---|
get_stats |
每个来源的文件数、最新和最早日期、大小。先调用它来了解来源名称 | source(可选) |
search |
排序的全文搜索 | query、source(可选)、limit(20) |
read |
一个条目:它的 Markdown、front matter、修改日期和大小 | source、id(不带 .md 的文件名) |
list |
一个来源的条目 | source、limit(50)、offset(0) |
get_recent |
最近更改的条目 | sources(逗号分隔,可选)、limit(20) |
get_metadata |
数量和上次同步时间 | source(可选) |
search 通过应用的索引对 Apple 备忘录、通讯录和信息进行排序:搜索一个名字就能找到对应的对话,备忘录的搜索结果会带有一个在 Apple 备忘录中打开它的链接。Bear、Logseq、屏幕使用时间和文档也会提供,但在索引可用时 search 不会对它们排序;请用 list、get_recent 和 read 访问它们。在索引还为空时,search 会扫描每个来源的 Markdown。
回答只会和导出一样完整:在免费额度内,就是你的前 100 条备忘录、100 位联系人和最近 10 个对话、10 天和 10 个文档。
隐私
服务器监听 127.0.0.1,所以 Mac 之外的任何东西都无法访问它,而且它只做读取。工具返回的内容会成为你与 AI 对话的一部分,并发送给它的模型,就像你粘贴的任何内容一样。
无法正常工作时
未设置导出文件夹。请先设置导出文件夹。:在任意卡片上选择一个导出文件夹未找到已导出的备忘录。请先运行一次导出。:在卡片上点按“立即同步”,然后点按“启动”- 点按“启动”时出现系统错误:另一个程序正在使用端口 8744。退出那个程序,然后重新启动
- 缺少某个来源:它位于上级文件夹之外、只导出了 HTML、在服务器启动后才出现,或者超出了免费额度