unfold-mcp

Name: unfold-mcp
Author: Bytestay

本地服务

unfold.bytestay.pt生产力0今天更新

代码仓库访问官网

关于 unfold-mcp

unfold-mcp 将 URL 或本地路径中的 PDF、DOCX、PPTX 和 XLSX 转为 Markdown，供 AI Agent 使用。它通过 stdio 本地运行，并使用市场平台密钥调用 Unfold API。

主要功能

01转换 PDF、DOCX、PPTX 和 XLSX
02支持 URL 和本地文件
03自动检测文档格式
04返回可设字符上限的 Markdown

适用场景

01提取报告内容供 AI Agent 使用
02将表格或演示文稿转为 Markdown
03处理公开 URL 中的文档

MCP 相关

该 MCP 服务向 MCP 客户端提供文档转换工具，通过 stdio 本地运行并调用 Unfold API。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "bytestay-unfold": {
      "command": "uvx",
      "args": [
        "bytestay-unfold-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>",
        "BYTESTAY_MARKETPLACE": "<BYTESTAY_MARKETPLACE>"
      }
    }
  }
}

启动命令uvx bytestay-unfold-mcp

需要配置的环境变量

RAPIDAPI_KEY密钥Your RapidAPI key

API_MARKET_KEY密钥Your api.market key, used when RAPIDAPI_KEY is not set

BYTESTAY_MARKETPLACErapidapi or apimarket, when both keys are set (the old name HFL_MARKETPLACE still works)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypibytestay-unfold-mcp0.2.8stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Unfold MCP 服务

让你的 AI Agent 将 PDF、Word（DOCX）、PowerPoint（PPTX）和 Excel（XLSX）文档的内容以 Markdown 格式呈现，支持使用 URL 或本地文件。

该服务开源（MIT）。它调用 Unfold API，该 API 为付费服务，但提供免费计划。

使用 你自己的密钥，可从 RapidAPI 或 api.market 获取。
每次工具调用都会计为计划中的一次请求。
免费 Basic 计划每月提供 15 次请求，并设有硬性上限，因此不会产生意外账单。

1. 获取密钥

平台
RapidAPI	计划
api.market	商店

2. 将服务添加到 MCP 客户端

该服务通过 uv 在本地使用 stdio 运行。将密钥放入其环境中。

JSON 配置（Claude Desktop、Cursor、VS Code 和大多数客户端）：

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

Claude Code：

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

环境变量

变量	含义
`RAPIDAPI_KEY`	你的 RapidAPI 密钥
`API_MARKET_KEY`	你的 api.market 密钥，在未设置 `RAPIDAPI_KEY` 时使用
`HFL_MARKETPLACE`	两个密钥均已设置时，使用 `rapidapi` 或 `apimarket`

没有密钥时，服务仍会启动。首次调用工具时会说明如何获取密钥。

也可在 Glama 上找到：

3. 工具

工具	功能
`convert_document(url=… \| path=…, max_chars=20000)`	将一个文档转换为 Markdown；提供公开 URL，或提供要上传的本地文件

系统会根据内容检测格式。

每个工具都会返回 API 的 JSON 响应。

如果平台提供了相关信息，响应中会添加 quota_remaining：你本月计划中剩余的请求次数。
错误会用通俗易懂的语言说明，并告知后续操作：
- 密钥被拒绝时，会提供订阅链接；
- 达到配额上限时，会提供计划信息；
- API 无法处理输入时，会提供 API 给出的原因。

隐私

只有在工具收到本地文件路径时才会读取文件。文件会发送给 API，用于处理该次请求。
API 会在内存中处理输入，不会存储。详见隐私政策。
你的密钥只会发送给你选择的平台。

限制

本地文件最大 10 MB。
Markdown 最大 500,000 个字符。
服务需要 Python 3.10+（uv 会为你安装）。

开发

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 会像客户端那样通过 stdio 运行服务，并调用其工具访问真实 API。它需要 RAPIDAPI_KEY 或 API_MARKET_KEY。