Doc_Conv — Document to Markdown

io.github.nicklee002e由 GitHub 账号 nicklee002e 发布v1.0.2更新于 Oct 24, 2026

Convert PDF/Word/Excel/PowerPoint documents to Markdown, paid in USDC via x402.

已验证STDIO仅桌面文件与存储金融

概览

AI 生成的概览

把 PDF、Word、Excel、PowerPoint 文档转换为 Markdown，可免费询价，并按次通过 Base 上的 x402 以 USDC 付费转换。

可以做什么
  • 询价：对本地文件估算页数、点数和 USDC 价格，免费且无需钱包。
  • 转换文档：按报价通过 x402 付款并取得 Markdown；含图片的文档返回 zip 下载链接。
  • 控制花费：为每次转换设置 USDC 上限，超出报价会被拒绝。
适用场景
适合助手需要读取 PDF、DOCX、XLSX 或 PPTX 等排版文件，而先转成 Markdown 能显著节省 token 的场景。可先用免费询价试用，确有转换需求时再配置有余额的钱包。
运行要求
以 PyPI 包 docconv-mcp 在本地运行（uvx 或 pip），仅限桌面端。estimate_conversion 无需账号或密钥。convert_document 需要 DOC_CONV_AGENT_PK，即持有 USDC 的 Base 钱包私钥；DOC_CONV_BASE_URL 可覆盖默认托管服务地址。需能访问 Doc_Conv 服务网络。
安装前请注意
convert_document 会从 DOC_CONV_AGENT_PK 对应钱包真实支出 USDC，务必保密该私钥、切勿提交到代码库。用 max_usdc 限制单次花费。文档内容会发送给第三方托管服务（CREPE Foundation）进行转换。转换失败时已付点数保留在付款钱包中。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Doc_Conv — Document to Markdown，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

docconv-mcp

MCP server for Doc_Conv — convert PDF / Word / Excel / PowerPoint documents to Markdown, paid per conversion with USDC on Base via the x402 protocol (gasless, EIP-3009). No account, no API key: the agent signs a USDC payment and the service returns Markdown.

Why? Feeding formatted files (PDF/PPT/DOCX) straight into an LLM can cost 5–50× more tokens than the same content as Markdown. This lets an agent cheaply pre-convert documents before use.

Tools

  • estimate_conversion(file_path) — free price quote (pages, credits, priceUsdc, jobId, jobToken). No payment, no side effects.
  • convert_document(file_path, max_usdc=1.0, poll_seconds=300) — pays via x402 (rejects if the quote exceeds max_usdc) and converts. Returns inline markdown for text documents, or a downloadUrl (zip) when the document contains images.

Try it without a wallet

Pricing is free and needs no key, no account, no wallet — install it and ask for a quote:

bash
claude mcp add doc-conv -- uvx docconv-mcp

Then: "How much would it cost to convert ~/papers/report.pdf?" — the agent calls estimate_conversion and answers. Add a wallet only when you want an actual conversion.

Install

Published to PyPI as docconv-mcp. Run with uvx (no install) or pip install docconv-mcp.

Configuration (env)

VariableDescriptionDefault
DOC_CONV_AGENT_PKPrivate key of the agent's Base wallet (must hold USDC). Signs x402 payments. Needed only by convert_document — estimate_conversion works without it. Secret — never commit or share.(unset: pricing only)
DOC_CONV_BASE_URLDoc_Conv service base URL. Override only if self-hosting.https://converter.crepe.fund

The wallet needs USDC on Base; gas is paid by the service's x402 facilitator (the agent needs no ETH). Pricing is by document size: 50 pages = 1 credit = 0.2 USDC (call estimate_conversion for the exact amount).

Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json)

json
{  "mcpServers": {    "doc-conv": {      "command": "uvx",      "args": ["docconv-mcp"],      "env": { "DOC_CONV_AGENT_PK": "0x<your-agent-wallet-private-key>" }    }  }}

Claude Code one-liner:

bash
claude mcp add doc-conv -- env DOC_CONV_AGENT_PK=0x<key> uvx docconv-mcp

Example

"Convert ~/papers/report.pdf to Markdown."

The agent calls estimate_conversion to see the price (e.g. 0.3 USDC), then convert_document to pay via x402 and return the Markdown. If conversion fails, the paid credit is retained on the payer wallet for reuse.

⚠️ convert_document spends real USDC. Use max_usdc to cap per-call cost.

Links

License

MIT © CREPE Foundation

来源：README.md，提交 e81916f

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

2
  1. v1.0.2最新Oct 18, 2026
  2. v1.0.1Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分