MCP 伺服器

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

啟動

1. 至少將一個 App 匯出為 Markdown（入門）。伺服器只讀取 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

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、在伺服器啟動後才出現，或已超過免費額度