Doc_Conv — Document to Markdown

docconv-mcp

适用于 Doc_Conv 的 MCP 服务——将 PDF / Word / Excel / PowerPoint 文档转换为 Markdown，并通过 x402 协议使用 USDC on Base 按次付费（免 Gas，EIP-3009）。无需账号，无需 API 密钥：Agent 签署 USDC 付款，服务即可返回 Markdown。

为什么要这样做？直接将格式化文件（PDF/PPT/DOCX）输入大模型，所需 Token 可能比相同内容的 Markdown 多出 5–50 倍。这让 Agent 能以低成本预先转换文档，再使用它们。

工具

• estimate_conversion(file_path) — 免费报价（pages、credits、priceUsdc、 jobId、jobToken）。无需付款，不会产生副作用。
• convert_document(file_path, max_usdc=1.0, poll_seconds=300) — 通过 x402 付款（若报价 超过 max_usdc 则拒绝），并进行转换。文本类文档会以内嵌的 markdown 返回；文档含有图片时则返回 downloadUrl（zip）。

无钱包即可试用

报价免费，无需密钥、无需账号、无需钱包——安装后即可询问报价：

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

然后询问：“将 ~/papers/report.pdf 转换需要多少钱？”——Agent 会调用 estimate_conversion 并回答。只有在需要实际转换时才添加钱包。

安装

已发布到 PyPI，包名为 docconv-mcp。可通过 uvx 运行（无需安装），也可使用 pip install docconv-mcp。

配置（环境变量）

变量	说明	默认值
DOC_CONV_AGENT_PK	Agent 的 Base 钱包私钥（必须持有 USDC）。用于签署 x402 付款。仅convert_document 需要此变量——estimate_conversion 无需此变量即可运行。机密信息——切勿提交或分享。	（未设置：仅可查询价格）
DOC_CONV_BASE_URL	Doc_Conv 服务的基础 URL。仅在自托管时覆盖。	https://converter.crepe.fund

钱包需要持有 USDC on Base；Gas 由服务的 x402 促成方支付（Agent 无需 ETH）。价格根据文档大小计算：50 页 = 1 个 credit = 0.2 USDC（调用 estimate_conversion 可获取确切金额）。

Claude Desktop / Claude Code（claude_desktop_config.json 或 .mcp.json）

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

Claude Code 单行命令：

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

示例

“将 ~/papers/report.pdf 转换为 Markdown。”

Agent 会调用 estimate_conversion 查看价格（例如 0.3 USDC），然后调用 convert_document， 通过 x402 付款并返回 Markdown。如果转换失败，已支付的 credit 会保留在付款方钱包中，以供重用。

⚠️ convert_document 会花费真实的 USDC。使用 max_usdc 限制每次调用的费用。

链接

• 服务：https://converter.crepe.fund
• Agent API（OpenAPI）：https://converter.crepe.fund/openapi.json
• x402 发现文档：https://converter.crepe.fund/.well-known/x402.json
• 运营方：CREPE Foundation

许可证

MIT © CREPE Foundation