关于 DocRaptor MCP by usefulapi
DocRaptor MCP by usefulapi 是托管式 MCP 服务,可从 HTML 或 URL 生成 PDF 和 Excel 文件,并通过异步任务查询状态。它面向 Claude、Cursor 等 MCP 客户端,使用者连接自己的 DocRaptor API 密钥。
主要功能
- 01从 HTML 或 URL 生成文档
- 02生成 PDF、XLS 或 XLSX
- 03查看异步任务状态
- 04列出已创建文档
适用场景
- 01将 HTML 内容转换为 PDF
- 02从网页地址生成 Excel 文件
- 03跟踪文档生成任务并查看记录
MCP 相关
托管的 MCP 服务向客户端提供文档生成、异步状态查询、文档列表和 DocRaptor IP 地址查询工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://docraptor.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-docraptor https://docraptor.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-docraptor":{"type":"http","url":"https://docraptor.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-docraptor":{"type":"http","url":"https://docraptor.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-docraptor":{"type":"http","url":"https://docraptor.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-docraptor":{"serverUrl":"https://docraptor.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
4| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| tag | string | 否 | 供你自行报告/分组使用的任意标签字符串。 |
| name | string | 否 | 文档名称(<=200 chars),显示在 DocRaptor 控制面板/列表中。 |
| test | boolean | 否 | 若为 true,则生成免费的带水印测试文档(不消耗额度)。默认 false = 正式付费文档。 |
| type | enum | 否 | 输出格式:pdf(默认)、xls 或 xlsx。pdf | xls | xlsx |
| async | boolean | 否 | 若为 true,则将任务加入队列并返回 status_id(使用 docraptor_get_document_status 轮询)。适用于大型/耗时较长的文档。默认 false。 |
| hosted | boolean | 否 | 若为 true(默认值),DocRaptor 将托管文件并返回 download_url。若为 false,则以 base64 返回原始文档。 |
| pipeline | string | 否 | 渲染管线/引擎版本,例如 '10'。省略时使用 DocRaptor 的默认值。 |
| document_url | string | 否 | DocRaptor 将获取并渲染的 URL。使用此参数或 document_content。 |
| prince_options | object | 否 | PDF 引擎(Prince)选项。仅限 PDF。 |
| prince_options.media | enum | 否 | CSS 媒体类型。“print”(默认)或“screen”。print | screen |
| prince_options.baseurl | string | 否 | 用于解析 document_content 中相对资源路径的基础 URL。 |
| prince_options.pdf_title | string | 否 | 嵌入 PDF 的标题元数据。 |
| prince_options.javascript | boolean | 否 | 渲染前在文档中运行 JavaScript。默认值为 false。 |
| prince_options.max_passes | integer | 否 | Prince 布局的最大处理次数(用于由 JS 驱动的布局)。 |
| document_content | string | 否 | 要渲染的 HTML/XML 源内容。使用此项或 document_url。 |
| hosted_expires_at | string | 否 | 对于托管文档:托管链接过期时间,使用 ISO 8601 日期时间格式。 |
| hosted_download_limit | integer | 否 | 对于托管文档:链接过期前的最大下载次数。 |
详细介绍
usefulapi 的 DocRaptor MCP
通过 Claude、Cursor 或任何 MCP 客户端,从 HTML 或 URL 生成 PDF 和 Excel 文档。托管服务,无需本地安装——使用你的 DocRaptor API 密钥连接。
实时端点: https://docraptor.usefulapi.io/mcp · 主页: https://usefulapi.io/docraptor
连接
- Claude(claude.ai、桌面版):打开 Customize → Connectors,点击 + Add → Add custom connector,然后粘贴
https://docraptor.usefulapi.io/mcp。 - Claude Code:
claude mcp add --transport http docraptor https://docraptor.usefulapi.io/mcp,然后运行/mcp登录。 - VS Code: 添加到 VS Code。
- Cursor 和其他客户端: 将 URL 添加为远程 MCP 服务:
{
"mcpServers": {
"docraptor": {
"url": "https://docraptor.usefulapi.io/mcp"
}
}
}
只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥:服务会通过 OAuth 为你登录,登录页面会要求你提供 DocRaptor 凭据。
分步设置指南、凭据查找位置和常见问题解答:https://usefulapi.io/docraptor/
首次连接时,你需要粘贴 DocRaptor API 密钥。密钥通过验证后会按用户存储,并仅限你本人使用。
工具
| 工具 | 类型 | 功能 |
|---|---|---|
docraptor_create_document | 写入 | 创建文档(PDF/XLS/XLSX) |
docraptor_get_document_status | 读取 | 获取异步文档状态 |
docraptor_list_documents | 读取 | 列出文档 |
docraptor_list_ip_addresses | 读取 | 列出 DocRaptor IP 地址 |
docraptor_usage_status | 元数据 | 使用情况(免费套餐用量计数) |
docraptor_request_feature | 元数据 | 申请添加缺失功能 |
docraptor_upgrade | 元数据 | 升级到 Pro(无限*) |
docraptor_cancel_subscription | 元数据 | 取消 Pro 订阅 |
read 工具是只读的;write 工具会修改数据(客户端应在执行前确认);meta 工具用于报告使用情况、管理订阅或发送功能请求。
定价
| 套餐 | 价格 | 限额 |
|---|---|---|
| Free | $0 | 每月 50 次工具调用 |
| Pro | $9/月 或 $90/年(赠送 2 个月) | 无限* |
*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。需要更多调用次数,请发送邮件至 [email protected]。
Pro 仅适用于此服务。使用 docraptor_upgrade 订阅(它会返回 Stripe Checkout 链接)。随时可以使用 docraptor_cancel_subscription 取消:Pro 会持续到已付费周期结束,当前周期不予退款;在此之前运行 docraptor_upgrade 可撤销取消操作。或者发送邮件至 [email protected]。
许可证
MIT — 详见 LICENSE。仅提供文档;服务由托管方提供。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。