# MCP 伺服器

讓 Claude 和其他 AI 代理搜尋你匯出的內容。

Exporter 在 App 內執行一個 MCP 伺服器。它以唯讀方式、只在你的 Mac 上，把你的匯出資料夾提供給 Claude、Cursor、VS Code 和其他任何 MCP 用戶端。AI 代理也能使用的技能和命令列，請見[給 AI 代理](https://exporter.dev/agents)。

## 啟動

1. 至少將一個 App 匯出為 Markdown（[入門](https://exporter.dev/docs/getting-started)）。伺服器只讀取 Markdown 檔案。
2. 在「MCP 伺服器」卡片上按「啟動」。卡片接著會顯示 `localhost:8744` 和一列「連接」。

端點是 `http://localhost:8744/mcp`（Streamable HTTP），使用固定連接埠。伺服器存在於 App 中：只要 Exporter 在執行，無論視窗是否打開，它都會回應，結束 App 時它就會停止。如果結束 App 時它正在執行，下次它會隨 App 一起啟動。伺服器運作時，`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 提供）。在 Claude 的 Settings > Developer > Edit Config 中，把它貼進 `mcpServers`，儲存後結束 Claude 再重新打開
- Cursor 或 VS Code：在卡片上按「cursor」或「vs code」。編輯器會打開，伺服器已準備好安裝；在那裡確認即可

## 它提供哪些資料夾

與 Apple 備忘錄匯出資料夾位於同一個上層資料夾中的匯出資料夾（沒有 Apple 備忘錄匯出資料夾時，則以它找到的第一個匯出資料夾為準）。放在其他地方的匯出資料夾，AI 代理看不到，「MCP 伺服器」卡片會說明它們能看到哪些。

| 匯出資料夾 | 提供 |
| --- | --- |
| `~/Documents/notes`、`~/Documents/messages` | 兩者 |
| `~/Documents/notes`、`~/Dropbox/messages` | 只有 notes |

要把某個資料夾納入，請在該 App 的 `匯出到` 列上按「更改…」，選擇同一個上層資料夾中的資料夾，然後在那張卡片上按「完全重新同步」。伺服器在啟動時讀取資料夾清單，所以任何變更之後請按「停止」再按「啟動」。每個來源都以它的資料夾命名，例如 `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` 會透過 App 的索引為 Apple 備忘錄、聯絡人和訊息排序：搜尋名字就能找到對話，備忘錄的搜尋結果會帶有一個可在 Apple 備忘錄中打開它的連結。Bear、Logseq、螢幕使用時間和文件也會提供，但在索引有回應時，`search` 不會為它們排序；請用 `list`、`get_recent` 和 `read` 取得它們。索引仍是空的時候，`search` 會掃描每個來源的 Markdown。

回答的完整程度取決於匯出內容：在免費額度下，就是前 100 則備忘錄、100 位聯絡人和最近 10 個對話、10 天和 10 個文件。

## 隱私權

伺服器監聽 127.0.0.1，所以 Mac 以外的任何東西都無法連到它，而且它只會讀取。工具傳回的內容會成為你和 AI 對話的一部分，並傳送到它的模型，就像你貼上的任何內容一樣。

## 無法運作時

- `No export folders configured. Set an export folder first.`：在任一張卡片上選擇匯出資料夾
- `No exported notes found. Run an export first.`：在卡片上按「立即同步」，然後按「啟動」
- 按「啟動」時出現系統錯誤：有其他程式正在使用連接埠 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-hant/docs/mcp
every page: https://exporter.dev/llms.txt