Unfold Mcp

io.github.hybridforgelab由 GitHub 帳號 hybridforgelab 發布v0.2.3更新於 Nov 6, 2026

PDF, DOCX, PPTX and XLSX documents to Markdown for AI agents, from a URL or a local file.

已驗證STDIO僅桌面檔案與儲存資料與分析

概覽

AI 產生的概覽

透過付費的 Unfold API，把來自網址或本機檔案的 PDF、DOCX、PPTX、XLSX 文件轉成 Markdown，供 AI 助理使用。

可以做什麼
  • 將單一文件轉成 Markdown，可提供公開網址或本機檔案路徑，並可限制回傳字元數
  • 回傳 API 的 JSON 回應，市集有提供時附上本月剩餘額度
  • 針對金鑰被拒、額度用盡或輸入無法處理等情況，給出淺顯的錯誤說明與後續建議
適用情境
適合助理需要讀取 PDF、Word、PowerPoint 或 Excel 檔案內容，並以 Markdown 文字處理時使用，檔案可來自網路或本機。
執行需求
以 uvx 透過 stdio 在本機執行（需 Python 3.10+，uv 會自動安裝）。需要 RapidAPI 或 api.market 的金鑰，透過 RAPIDAPI_KEY 或 API_MARKET_KEY 提供；兩個金鑰都設定時以 HFL_MARKETPLACE 指定市集。需要連線至 Unfold API 的網路。本機檔案上限 10 MB，輸出上限 500,000 字元。
安裝前請注意
Unfold API 為付費服務，免費方案每月 15 次請求；每次工具呼叫都算一次請求。以路徑提供的本機檔案會上傳到 API 處理，請勿傳送機密文件。金鑰只會傳給所選市集，但仍屬機密，不應寫入共用設定。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

Unfold MCP server

[M8ven Score] [CI] [PyPI] [Python 3.10+] [License: MIT]

Give your AI agent the content of PDF, Word (DOCX), PowerPoint (PPTX) and Excel (XLSX) documents as Markdown, from a URL or a local file.

The server is open source (MIT). It calls the Unfold API, which is paid, with a free plan.

  • You use your own key, from RapidAPI or api.market.
  • Every tool call is one request on your plan.
  • The free Basic plan has 15 requests a month, with a hard limit, so it never runs up a bill.

1. Get a key

marketplace
RapidAPIplans
api.marketstore

2. Add the server to your MCP client

The server runs locally over stdio with uv. Put your key in its environment.

JSON configuration (Claude Desktop, Cursor, VS Code and most clients):

json
{  "mcpServers": {    "unfold": {      "command": "uvx",      "args": ["--from", "hybridforgelab-unfold-mcp", "unfold-mcp"],      "env": { "RAPIDAPI_KEY": "your-rapidapi-key" }    }  }}

Claude Code:

bash
claude mcp add unfold --env RAPIDAPI_KEY=your-rapidapi-key -- uvx --from hybridforgelab-unfold-mcp unfold-mcp

Environment

variablemeaning
RAPIDAPI_KEYyour RapidAPI key
API_MARKET_KEYyour api.market key, used when RAPIDAPI_KEY is not set
HFL_MARKETPLACErapidapi or apimarket, when both keys are set

Without a key the server still starts. The first tool call then explains where to get one.

Also listed on Glama:

[unfold-mcp on Glama]

3. Tools

toolwhat it does
convert_document(url=… | path=…, max_chars=20000)converts one document to Markdown; give a public URL, or a local file to upload

The format is detected from the content.

Every tool returns the API's JSON response.

  • When the marketplace reports it, quota_remaining is added: the requests left on your plan this month.
  • Errors are explained in plain words, with what to do next:
    • key refused, with the link to subscribe;
    • quota reached, with the plans;
    • input the API couldn't process, with the API's reason.

Privacy

  • Local files are read only when a tool is given their path. They are sent to the API for that one request.
  • The API processes inputs in memory and doesn't store them. See the privacy policy.
  • Your key is only sent to the marketplace you chose.

Limits

  • Local files up to 10 MB.
  • Markdown up to 500,000 characters.
  • The server needs Python 3.10+ (uv installs it for you).

Development

bash
uv venv && uv pip install -e ".[dev]".venv/bin/pytest            # unit tests, no network; 100% coverage required.venv/bin/ruff check src tests scripts

scripts/e2e_stdio.py unfold runs the server over stdio, as a client would, and calls its tools against the real API. It needs RAPIDAPI_KEY or API_MARKET_KEY.

Licence

MIT. Unfold itself is a paid API with a free plan, run by Hybrid Forge Lab.

來源：README.md，提交 fa7dcb4

工具

0
SourceWeft 曾在隔離沙箱中以無憑證方式啟動該軟體包一次，以列出其工具，但未能完成：該軟體包類型無法在沙箱中執行。

版本歷史

3
  1. v0.2.3最新Nov 6, 2026
  2. v0.2.2Nov 3, 2026
  3. v0.2.0Nov 3, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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