適用於 Cursor 的 Aktar
從 Cursor 上傳檔案到你自己的儲存貯體
把 Aktar 加入 Cursor,它的代理程式就能把圖片和檔案上傳到你自己的 S3、Cloudflare R2 或 Backblaze B2 儲存貯體,產生暫時連結,還能查看儲存貯體裡的內容。它在你電腦上的 Aktar App 旁邊執行,所以你的儲存金鑰始終不會離開 Aktar。
開始設定getaktar/cliv0.6.0
上傳 public/og-image.png,並在 og:image meta 標籤中使用它的 URL。
upload_file{ "path": "public/og-image.png" }已上傳。我把這個 URL 放進了 og:image 標籤:
https://files.example.com/2026/11/og-image.png你可以這樣說
-
用於文件和更新記錄的圖片
“上傳 docs/ 裡的螢幕截圖,並在 CHANGELOG.md 中加上連結。”
代理程式逐一上傳圖片,並把連結寫在適當的位置。Aktar 依目的地的設定轉換和清理圖片。
工具:
upload_file -
會過期的連結
“給我 Builds 儲存貯體裡 backup.sql 的 30 分鐘連結。”
為儲存貯體中的任何檔案產生預先簽署的連結,適用於私有儲存貯體或限時分享。儲存貯體裡的內容不會有任何變化,除非你允許更長,否則連結最長有效 60 分鐘。
工具:
create_temporary_link -
查看儲存貯體裡的內容
“我的 Downloads 儲存貯體裡 releases 資料夾有什麼?”
它會列出資料夾和檔案,包括不是透過 Aktar 上傳的檔案。
工具:
list_bucket
設定步驟
安裝 Mac 或 Windows 版 Aktar,並新增一個目的地(你的儲存貯體)。在 Aktar 中打開設定 > 整合,開啟允許本機連線並複製權杖,然後把它貼到這個指令中。需要 Node.js 18 或更新版本。
npx @getaktar/cli login在你的專案中建立
.cursor/mcp.json,內容如下。${workspaceFolder}就是專案資料夾,所以 Aktar 只從這個專案上傳檔案。在 .cursor/mcp.json 中{ "mcpServers": { "aktar": { "command": "npx", "args": ["-y", "@getaktar/cli", "mcp", "--root", "${workspaceFolder}"] } } }打開 Cursor 的設定,在 MCP 清單中找到
aktar,確認它已開啟。之後代理程式就能看到 Aktar 的工具。
若要在所有專案中使用 Aktar,把同樣的內容放進 ~/.cursor/mcp.json,並把 ${workspaceFolder} 換成一個資料夾,例如 /Users/you/Projects(在 Windows 上為 C:\\Users\\you\\Projects)。若要允許更多資料夾,就重複 --root 和資料夾。
因為資料夾是用 --root 指定的,所以不提供直接從剪貼簿上傳的功能,請改為把檔案指給代理程式。若要讓它取代或刪除上傳項目,在引數中加上 --allow-replace 或 --allow-delete。如果 Cursor 無法啟動 npx,請把 which npx 輸出的完整路徑填到 command 中。
它能碰什麼
檔案只來自伺服器可以使用的資料夾,SSH 金鑰、.env 檔案和雲端服務憑證等機密絕不會被上傳。取代和刪除上傳項目預設關閉,除非你自己開啟。你的儲存金鑰留在 Aktar 中:代理程式拿到的只是檔名和連結,任何內容都不會傳給我們。上傳的檔案對任何拿到連結的人都是公開的,所以只請它上傳你想分享的內容。
常見問題
Cursor 會拿到我的儲存金鑰嗎?
不會。你的金鑰留在 Aktar App 中。伺服器只使用 npx @getaktar/cli login 儲存在只有你能讀取的檔案中的本機權杖,並在 127.0.0.1 上與 Aktar 通訊。
代理程式上傳前會先詢問嗎?
除非你為某個 MCP 工具開啟了自動執行,否則 Cursor 在執行它之前會先詢問。搜尋、列出和暫時連結只是查看,上傳會修改你的儲存貯體。
能一次在所有專案中使用嗎?
可以。改為把設定放進 ~/.cursor/mcp.json,並在 --root 後面寫上允許它上傳檔案的資料夾。
支援 Windows 嗎?
支援,需要 Windows 版 Aktar 0.11.0 或更新版本。在 Mac 上需要 Mac 版 Aktar 0.18.0 或更新版本。