内容
# docconv-mcp
<!-- mcp-name: io.github.nicklee002e/docconv-mcp -->
MCP 服务器，用于 **[文档转换](https://converter.crepe.fund)** — 将 PDF / Word / Excel / PowerPoint 文档转换为 **Markdown**，通过 [x402](https://x402.org) 协议（无 Gas 费用，EIP-3009）以 **USDC on Base** 支付转换费用。无需账户，无需 API 密钥：代理人签署 USDC 支付，服务返回 Markdown。
为什么？直接将格式化文件（PDF/PPT/DOCX）输入 LLM 可能比相同内容以 Markdown 格式的成本高 **5–50 倍**。这使得代理人可以在使用前廉价地预先转换文档。
## 工具
- **`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）。
## 安装
已在 PyPI 上发布为 [`docconv-mcp`](https://pypi.org/project/docconv-mcp/)。使用 [`uvx`](https://docs.astral.sh/uv/)（无需安装）或 `pip install docconv-mcp` 运行。
## 配置（环境变量）
| 变量 | 描述 | 默认值 |
|---|---|---|
| `DOC_CONV_AGENT_PK` | 代理人 **Base 钱包** 的私钥（必须持有 USDC）。签署 x402 支付。**机密 — 勿提交或分享。** | *(必填)* |
| `DOC_CONV_BASE_URL` | 文档转换服务基准 URL。自托管时才需要覆盖。 | `https://converter.crepe.fund` |
钱包需要 **Base 上的 USDC**；服务的 x402 促进者支付 Gas 费用（代理人无需 ETH）。定价按文档大小计算：50 页 = 1 积分 = 0.2 USDC（调用 `estimate_conversion` 获取确切金额）。
## Claude Desktop / Claude Code (`claude_desktop_config.json` 或 `.mcp.json`)
```json
{
"mcpServers": {
"doc-conv": {
"command": "uvx",
"args": ["docconv-mcp"],
"env": { "DOC_CONV_AGENT_PK": "0x<您的代理人钱包私钥>" }
}
}
}
```
Claude Code 一行命令：
```bash
claude mcp add doc-conv -- env DOC_CONV_AGENT_PK=0x<密钥> uvx docconv-mcp
```
## 示例
> “将 `~/papers/report.pdf` 转换为 Markdown。”
代理人调用 `estimate_conversion` 查看价格（例如 0.3 USDC），然后调用 `convert_document` 通过 x402 支付并返回 Markdown。如果转换失败，已支付的积分将保留在付款人钱包中以供重复使用。
> ⚠️ `convert_document` 会消耗真实的 USDC。请使用 `max_usdc` 限制每次调用的成本。
## 链接
- 服务：https://converter.crepe.fund
- 代理人 API（OpenAPI）：https://converter.crepe.fund/openapi.json
- x402 发现：https://converter.crepe.fund/.well-known/x402.json
- 运营商：[CREPE 基金会](https://crepe.fund)
## 许可证
MIT © CREPE 基金会
