Filewash

io.github.cassilup由 GitHub 帳號 cassilup 發布v0.1.0更新於 Oct 24, 2026

Privacy-first file tools for AI agents — PDF & image ops, metadata scrubbing, background removal.

已驗證STDIO僅桌面檔案與儲存媒體與設計

概覽

AI 產生的概覽

讓助理在本機處理 PDF 與圖片：合併、拆分、旋轉、壓縮、轉檔、縮放、清除中繼資料以及去背。

可以做什麼
Filewash 向助理提供十一項檔案處理工具：PDF 合併、拆分、旋轉與中繼資料清除，以及圖片壓縮、格式轉換、縮放、EXIF/GPS/ICC/XMP 中繼資料清除、去背、浮水印與 QR code 產生。它以本機 stdio MCP 伺服器形式透過 node 啟動，同一套邏輯也提供計量式 REST API 與 npm SDK。據稱處理在記憶體中進行，不記錄檔案內容。
適用情境
適合助理在分享檔案或把檔案交給模型之前需要整理文件與圖片的場景，尤其是檔案不應上傳到第三方服務的工作流程。中繼資料清除與去背是它強調的較少見能力。
執行需求
需要本機 Node.js 執行環境；清單宣告不需驗證、環境變數或標頭。README 的 REST API 範例使用名為 FILEWASH_KEY 的 bearer 金鑰，但那只適用於託管 API，不適用於本機 stdio 伺服器。僅限桌面端，無網頁可執行版本。
安裝前請注意
此 MCP 伺服器會把輸出檔案寫入你指定的路徑，因此可能在磁碟上建立或覆寫檔案。託管 REST API 依方案計量收費，其範例會把檔案傳送到遠端端點並附帶 bearer 金鑰；本機伺服器則不需上傳。隱私與零保留的說法應視為廠商聲明。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Filewash，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

filewash — privacy-first file tools for AI agents

The file-processing layer for agents and apps that can't send files to a third party. Compress, convert, resize, merge/split PDFs, strip metadata, and remove backgrounds — exposed as an MCP server, a metered REST API, and an npm SDK. Zero-retention by default: files are processed in memory and never stored or logged.

Built from filewash.app's client-side WASM tools. Same logic, now callable by your agents.

Why this exists

Every other file-tools API and MCP server is a wrapper around an upload-to-server service. That's a non-starter for legal, healthcare, finance, and any GDPR-bound workflow — and it's a liability when you're piping documents into an LLM. filewash is the one built around not keeping your files, with two tools nobody else ships as an MCP: background removal and metadata scrubbing.

MCP server (Claude Desktop, Cursor, Claude Code)

jsonc
// claude_desktop_config.json  →  mcpServers{  "filewash": { "command": "node", "args": ["/path/to/filewash-api/src/mcp/server.js"] }}

Your agent now has 11 tools. Ask it: "strip the location metadata from these photos before I upload them" or "merge these contracts and rotate the scanned pages."

REST API

bash
# discovercurl https://api.filewash.app/v1/tools
# strip EXIF/GPS from a photo (returns the cleaned image)curl -X POST https://api.filewash.app/v1/tools/image_strip_metadata \  -H "Authorization: Bearer $FILEWASH_KEY" \  -F '[email protected]' -o clean.jpg
# merge PDFscurl -X POST https://api.filewash.app/v1/tools/pdf_merge \  -H "Authorization: Bearer $FILEWASH_KEY" \  -F '[email protected]' -F '[email protected]' -o merged.pdf

Every response carries X-Filewash-Meta (operation result) and X-Filewash-Quota-Remaining.

Tools

ToolCategoryWhat it does
pdf_mergepdfMerge PDFs into one
pdf_splitpdfExtract specific pages
pdf_rotatepdfRotate pages by 90°
pdf_strip_metadataprivacyRemove author/title/producer/dates
image_compressimageLossy re-encode at a target quality
image_convertimagejpeg ↔ png ↔ webp ↔ avif
image_resizeimageResize (never upscales)
image_strip_metadataprivacyStrip EXIF/GPS/ICC/XMP
image_remove_backgroundimageRemove background → transparent PNG (local AI model, no upload)
image_watermarkimageTile a text watermark
qr_generategenerateQR code PNG from text/URL

Pricing (planned)

PlanPriceQuotaRetention
Free$0100 ops/moin-memory
Pro~$19/mo10,000 ops/moin-memory
Business~$99/mounlimitedzero-retention guarantee + audit log + BAA

Run locally

bash
npm installnpm run test:engine   # 10 tools, end-to-end, no browsernpm run mcp           # stdio MCP servernpm run rest          # REST API on :8787  (try key "demo")

Privacy

No file is written to disk by the REST API; the MCP server writes output only to the path you pass. No file contents are logged. The Business tier adds a contractual zero-retention guarantee and audit logging.

來源：README.md，提交 72a9aef

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分