# MCP 服务器

让 Claude 和其他智能体搜索你导出的内容。

Exporter 在应用内运行一个 MCP 服务器。它把你的导出文件夹提供给 Claude、Cursor、VS Code 和其他任何 MCP 客户端，只读，并且只在你的 Mac 上。智能体还能使用的技能和命令行，请参阅[面向智能体](https://exporter.dev/agents)。

## 启动

1. 至少以 Markdown 导出一个应用（[开始使用](https://exporter.dev/docs/getting-started)）。服务器只读取 Markdown 文件。
2. 在 MCP 服务器卡片上点按“启动”。卡片随后会显示 `localhost:8744` 和一行“连接”。

端点是 `http://localhost:8744/mcp`（Streamable HTTP），端口固定。服务器运行在应用中：只要 Exporter 在运行，无论窗口打开还是关闭，它都会响应，退出应用时它会停止。如果退出时它正在运行，下次它会随应用一起启动。服务器运行期间，`curl -s http://127.0.0.1:8744/health` 会返回 `OK`。

## 连接 Claude Code

```sh
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、在服务器启动后才出现，或者超出了免费额度

## Related

- [For agents](https://exporter.dev/agents): Skills, command line and MCP for agents
- [Apple Notes in Claude](https://exporter.dev/guides/notes/apple-notes-in-claude): Claude searches your notes, on your Mac
- [CLI](https://exporter.dev/docs/cli): Every command, flag and exit code

---

human version: https://exporter.dev/zh-hans/docs/mcp
every page: https://exporter.dev/llms.txt