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 元数据清除、背景去除、水印和二维码生成。它以本地 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 分