Distill Mcp

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

Convert PDF, DOCX, XLSX, PPTX, HTML, audio to token-efficient Markdown for any MCP client.

已驗證STDIO僅桌面檔案與儲存知識與記憶

概覽

AI 產生的概覽

將本機 PDF、DOCX、XLSX、PPTX、HTML 與音訊等文件轉換為節省 token 的 Markdown，供 MCP 用戶端使用。

可以做什麼
Distill Mcp 提供 convert_and_save 工具，在模型讀取之前把本機檔案轉換成乾淨的 Markdown，相較原始文件文字通常可減少 40% 到 80% 的 token。它支援 Word、Excel、PowerPoint、原生文字 PDF、HTML、EPUB、JSON、SQL 與 WSDL 檔案；完整模式還支援以 OCR 處理掃描版 PDF 以及音訊格式。轉換結果會被快取，工具會回報是否覆蓋了先前的快取版本以及任何警告。
適用情境
適合助理需要讀取或推理本機文件且上下文預算有限的情境，例如摘要報告、試算表或簡報。也適合用戶端被設定為先轉換檔案、而不是透過檔案系統工具直接讀取原始檔案的流程。
執行需求
透過 stdio 在本機執行，以 npx -y distill-mcp-server 啟動，因此需要 Node.js。輕量模式還需要 Python 與 pip，透過環境變數 DISTILL_MCP_CONFIG 設定 python_path。完整模式需要 Docker 並在本機執行 Distill 服務，透過 DISTILL_MCP_CONFIG 設定 distill_url。未宣告需要帳號或 API 金鑰。
安裝前請注意
此伺服器依路徑讀取本機檔案並寫入轉換後的 Markdown，可能覆蓋先前的快取轉換結果，工具會以 overwritten 旗標回報。完整模式會把文件內容傳送到本機 Docker 服務而非外部服務，但該服務必須正在執行且可連線。README 聲明所有處理都在本機進行，資料不會離開這台電腦。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

distill-mcp

[npm version] [license] [MCP Registry]

An MCP server that connects any MCP-compatible client to Distill, converting local documents to clean, token-efficient Markdown before the LLM reads them. Typical token reduction is 40–80% compared to raw document text, letting the model fit more content into its context window and reason over it faster.

Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any other MCP client that supports tool calling.

Two Modes

LightweightFull (Docker)
Requires DockerNoYes
DOCX, XLSX, PPTX, native PDF, HTMLYesYes
Scanned PDF (OCR)NoYes
Audio (MP3, WAV, etc.)NoYes
Quality scoreNoYes
Install time~2 min~10 min

Lightweight needs only Python and pip. Full needs Docker with the Distill service running. See the setup guides for details.

Quick install

No global install required:

bash
npx -y distill-mcp-server

Then configure Claude Desktop — see Lightweight setup or Full setup for step-by-step instructions.

Configuration

Add the server to your claude_desktop_config.json.

Lightweight mode — macOS / Linux:

json
{  "mcpServers": {    "distill-mcp": {      "command": "npx",      "args": ["-y", "distill-mcp-server"],      "env": {        "DISTILL_MCP_CONFIG": "{\"mode\":\"lightweight\",\"python_path\":\"python3\"}"      }    }  }}

Lightweight mode — Windows:

json
{  "mcpServers": {    "distill-mcp": {      "command": "npx",      "args": ["-y", "distill-mcp-server"],      "env": {        "DISTILL_MCP_CONFIG": "{\"mode\":\"lightweight\",\"python_path\":\"py\"}"      }    }  }}

Full mode — all platforms:

json
{  "mcpServers": {    "distill-mcp": {      "command": "npx",      "args": ["-y", "distill-mcp-server"],      "env": {        "DISTILL_MCP_CONFIG": "{\"mode\":\"full\",\"distill_url\":\"http://localhost:7860\"}"      }    }  }}

Full config key reference is in the setup guides: Lightweight | Full

CLAUDE.md snippet

Paste this into your project's CLAUDE.md so Claude knows how to use the tool automatically. Copy the block below as-is:

markdown
## Document Conversion — distill-mcp
When the user references a local file path (e.g. a PDF, DOCX, PPTX, XLSX,HTML, or audio file), ALWAYS call the `convert_and_save` tool before readingor reasoning about the document. Do not read the original file directly viafilesystem tools — use only the Markdown returned by `convert_and_save` asthe document content.
### Rules
1. Call `convert_and_save` with the absolute file path before doing anything   else with the document.2. Use ONLY the Markdown output from `convert_and_save` as the document   content. Never read the original file with filesystem tools.3. If the response includes `"overwritten": true`, tell the user that a   previous cached version was replaced before proceeding.4. If the response includes any `warnings`, surface them to the user before   proceeding with the document content.5. If `convert_and_save` returns an unsupported format error, tell the user   which formats are supported and suggest switching modes if applicable.
### Supported formats
| Category | Lightweight | Full (Docker) ||---|---|---|| Word | .docx, .doc, .odt | .docx, .doc, .odt || Excel | .xlsx, .xlsm, .csv | .xlsx, .xlsm, .csv || PowerPoint | .pptx, .ppt | .pptx, .ppt || PDF | .pdf (native text) | .pdf (native + scanned OCR) || HTML | .html, .htm | .html, .htm || Audio | — | .mp3, .wav, .m4a, .flac, .ogg || Other | — | .epub, .json, .sql, .wsdl, .wsd |
### Usage
Say "convert using distill" followed by the file path:> Convert using distill C:\Users\me\Documents\report.pdf to markdown

The snippet is also available in docs/CLAUDE.md-snippet.md.

Supported formats

CategoryExtensionsLightweightFull
Microsoft Word.docx, .doc, .odtYesYes
Microsoft Excel.xlsx, .xlsm, .csvYesYes
Microsoft PowerPoint.pptx, .pptYesYes
PDF (native text).pdfYesYes
PDF (scanned/OCR).pdfNoYes
HTML.html, .htmYesYes
Audio.mp3, .wav, .m4a, .flac, .oggNoYes
EPUB.epubNoYes
JSON.jsonNoYes
SQL.sqlNoYes
WSDL.wsdl, .wsdNoYes

Privacy

All processing happens locally. In lightweight mode, documents are converted by the distill-core Python library on your machine — no data leaves your computer. In full mode, documents are sent to the Distill Docker service running locally on your machine — no data is sent to external services.

Built on

Distill — document-to-Markdown conversion engine.

License

MIT

來源：README.md，提交 da01804

工具

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

版本歷史

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

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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