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」。編輯器會打開，伺服器已準備好安裝；在那裡確認即可

它提供哪些資料夾

每個匯出資料夾，無論位於何處，各自以它的資料夾名稱命名，例如 notes 或 messages。名稱相同的兩個資料夾會以上層資料夾的名稱區分，例如 export (Bear)。伺服器在啟動時讀取資料夾清單，所以任何變更之後請按「停止」再按「啟動」。

六個工具

工具	用途	參數
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 備忘錄、聯絡人和訊息會透過 App 的索引排序：搜尋名字就能找到對話，備忘錄的搜尋結果會帶有一個可在 Apple 備忘錄中打開它的連結。其他每個 App 的檔案，包括郵件、行事曆、Bear、提醒事項和文件，會在旁邊一併掃描，兩份清單在結果中輪流出現。索引仍是空的時候，search 會掃描每個來源的 Markdown。

回答的完整程度取決於匯出內容：在免費額度下，就是前 100 則備忘錄、100 位聯絡人和最近 50 個對話、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、在伺服器啟動後才出現，或已超過免費額度