PDF Toolkit

com.tensormaster由 tensormaster.com 发布官方发布者v1.0.2更新于 Oct 24, 2026

Convert PDFs/images to Word, Excel, and Markdown. Split, merge, and watermark PDF files.

已验证Streamable HTTP可网页运行效率与工作流文件与存储

概览

AI 生成的概览

远程 PDF 工具箱，让助手把 PDF 和图片转成 Word、Excel 或 Markdown，并拆分、合并、加水印或组装 PDF。

可以做什么
把 PDF 和图片转换为 Word、Excel 或 Markdown 文档，每个任务带幂等键，重试不会重复扣费。按每份页数拆分 PDF，按数组顺序合并 2 至 10 个 PDF，把 1 至 10 张图片生成 PDF。为 PDF 添加文字水印。轮询任务状态与结果链接，列出当前用户的任务，并查询格式、大小和数量等能力限制。
适用场景
适合需要把扫描件或电子 PDF、图片转成可编辑的 Word、Excel 或 Markdown，或对 PDF 进行拆分、合并、加水印和图片打包的场景。适用于能访问远程 Streamable HTTP 端点并完成 OAuth 或发送 API Key 请求头的客户端。
运行要求
远程 Streamable HTTP 端点，无需本地安装包。OAuth（动态客户端注册与 PKCE S256），或在 Authorization 请求头中手动提供 API Key。需要 MiaoDashi 账号，并需要积分支付 PDF 处理费用。源文件必须可通过临时 HTTPS 链接访问。
安装前请注意
处理按积分计费，积分不足会导致任务失败。API Key 只显示一次，不得放入 URL、查询参数、日志或聊天内容，泄露后应立即撤销。任务会生成文件并归属于所属账号。文件由第三方 HTTPS 链接拉取，避免使用携带凭据的链接。

安装

在 SourceWeft 中

  1. 打开 控制台中的 PDF Toolkit，将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.tensormaster%2Fpdf/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "pdf-toolkit": {
      "type": "http",
      "url": "https://api.tensormaster.com/pdf/mcp"
    }
  }
}

README

PDF 工具箱 MCP 接入说明

English

[MCP] [OAuth] [PDF Tools] [MCP Registry - com.tensormaster/pdf] [pdf-mcp MCP connector – tool definition quality and endpoint health on Glama] [Smithery - PDF Toolkit]

PDF 工具箱是一个面向 Agent 的 MCP 文件处理服务，通过 Streamable HTTP 提供 PDF/图片转 Word、Excel、Markdown、PDF 拆分合并、图片转 PDF、文字水印和异步任务查询能力。支持 OAuth 和手动 API Key 两种授权方式。

1. 快速选择

场景推荐方式
豆包正式接入OAuth
MCP Client 支持浏览器授权OAuth
MCP Client 不支持 OAuth，但支持自定义 Header手动 API Key
curl、SDK、本地调试手动 API Key

2. 固定配置

项目值
MCP 服务地址https://api.tensormaster.com/pdf/mcp
传输方式Streamable HTTP
Resourcehttps://api.tensormaster.com/pdf/mcp
OAuth 注册方式DCR（Dynamic Client Registration）
Scopemcp:tools offline_access，使用 ASCII 空格分隔
客户端认证none，Public Client + PKCE
Response Typecode
Grant Typeauthorization_code、refresh_token
PKCE必须使用 S256
Redirect URI注册时传入，后续精确匹配，不支持通配符
OAuth Discoveryhttps://miaodashi.com/.well-known/oauth-authorization-server
Authorization Endpointhttps://miaodashi.com/oauth/authorize
Token Endpointhttps://miaodashi.com/api/oauth/token
Refresh Token Endpoint留空，复用 Token Endpoint
DCR 注册地址https://miaodashi.com/api/oauth/register

3. OAuth：豆包推荐方式

在豆包中按以下步骤操作：

  1. 在远程 MCP/Connector 中填写：

    text
    https://api.tensormaster.com/pdf/mcp

  2. 点击“去授权”

  3. 浏览器打开 MiaoDashi 授权页面；首次使用先注册，已有账号直接登录。

  4. 核对客户端名称、PDF 工具箱和权限范围，点击“同意授权”。

  5. 页面返回豆包后，确认状态显示“授权成功”或“已连接”。

DCR、state、PKCE、授权码兑换、Access Token 和 Refresh Token 均由豆包与 MiaoDashi 自动完成，用户无需手动复制授权码或 Token。Access Token 过期后，豆包使用 Refresh Token 自动续期。

Claude 接入步骤

将以下指令发送给 Claude：

text
帮我在设置里添加一个新的 MCP 连接器，地址是 https://api.tensormaster.com/pdf/mcp。添加后提醒我确认授权页面上的权限范围，再点同意。

然后按以下步骤完成授权：

  1. 退出 Claude，再重新进入 Claude。
  2. 输入 /mcp，选择 PDF 服务并进行授权。
  3. 确认授权成功后，即可使用 PDF 工具箱。

Codex（ChatGPT）接入步骤

  1. 打开 设置 → 插件 → 添加 → 添加 MCP 服务器。

  2. 填写：

    text
    名称：pdf类型：流式 HTTPURL：https://api.tensormaster.com/pdf/mcp

  3. 点击“保存”。

  4. 点击“进行身份验证”，注册或登录 MiaoDashi 网站，并在授权页面确认权限后点击“同意”。

  5. 返回设置页，确认“进行身份验证”按钮消失，即表示授权成功，可以使用 PDF 工具箱。

ChatGPT 的菜单名称可能因账号、工作区权限或版本略有差异；如果看不到添加 MCP 服务器入口，请先确认已启用相应的开发者模式或自定义连接器权限。

4. 手动 API Key：兼容方式

4.1 获取 API Key

  1. 打开 MiaoDashi API Keys，登录需要承担 PDF 费用的账号。
  2. 点击“创建 API Key”，填写名称，例如 pdf-mcp-local。
  3. 选择 PDF 工具需要的最小权限，至少需要文件处理/生成权限；按需设置过期时间。
  4. 创建成功后立即复制完整 Key。完整 Key 通常只显示一次，请保存到密码管理器或 MCP Client 安全存储。

不要使用网页内部 Key、OAuth Token、Device Flow Key 或其他服务的 Key。

4.2 配置 MCP Client

MCP Gateway 已启用手动 Key 兼容入口时，使用：

json
{  "mcpServers": {    "pdf-toolkit": {      "type": "streamableHttp",      "url": "https://api.tensormaster.com/pdf/mcp",      "headers": {        "Authorization": "Bearer md_api_<your_key>"      }    }  }}

也可以直接发送：

text
Authorization: Bearer md_api_<your_key>

不要把 API Key 放到 URL、Query、日志或聊天内容中。先调用 get_pdf_toolbox_capabilities 验证连接，再提交转换任务。

5. 工具列表

工具主要参数说明
convert_file_to_wordfile_url, idempotency_keyPDF/图片转 DOCX
convert_file_to_excelfile_url, idempotency_keyPDF/图片转 XLSX
convert_file_to_markdownfile_url, idempotency_keyPDF/图片转 Markdown
split_pdffile_url, pages_per_file, idempotency_key拆分 PDF，结果通常为 ZIP
merge_pdfsfile_urls, size, idempotency_key按数组顺序合并 PDF
images_to_pdfimage_urls, scale, idempotency_key图片生成 PDF
add_pdf_watermarkfile_url, 水印参数, idempotency_key添加文字水印
get_pdf_tasktask_id查询状态、结果 URL、错误和积分
list_pdf_taskscursor, limit查询当前用户的任务列表
get_pdf_toolbox_capabilities无查询格式、数量、大小和服务限制；无副作用

参数和任务规则

  • MCP 请求使用 JSON-RPC，不接收 multipart/form-data。
  • 用户附件必须映射为临时 HTTPS URL：单文件使用 file_url，多文件使用 file_urls 或 image_urls。
  • split_pdf.pages_per_file 为 1..50；merge_pdfs 支持 2～10 个文件；images_to_pdf 支持 1～10 张图片；scale 为 (0, 1]。
  • 创建任务必须使用 idempotency_key；相同参数重试不会重复创建或扣费。
  • 任务状态：queued → running → succeeded/failed。使用 get_pdf_task 轮询，不要重复创建任务。
  • 任务只能由所属用户查询。

6. 常见错误

错误处理方式
401 / AUTH_REQUIREDOAuth 重新授权；手动模式检查 Key、过期和撤销状态
403 / INSUFFICIENT_SCOPE补充正确权限或重新授权
INVALID_INPUT按 tools/list 返回的 schema 修正参数
UNSUPPORTED_FILE_TYPE / FILE_TOO_LARGE查询 capabilities，转换格式或压缩文件
SOURCE_URL_FORBIDDEN使用可访问的 HTTPS 临时 URL，不携带凭据
INSUFFICIENT_CREDITS充值或切换有额度的账号
CONCURRENCY_LIMITED等待已有任务完成
TASK_NOT_FOUND检查 task ID；不能访问其他用户任务
UPSTREAM_UNAVAILABLE稍后使用相同 idempotency_key 重试

7. 安全要求

  • 全部 MCP、OAuth、Token 和发现地址使用 HTTPS。
  • Access Token、Refresh Token 和 API Key 只能放在 Authorization Header。
  • 不要记录完整凭据、内部 JWT、Supabase 密钥或签名下载 URL。
  • 文件 URL 必须经过 HTTPS、大小、重定向、DNS/IP 和超时校验，防止 SSRF。
  • 怀疑 API Key 泄露时，立即在 MiaoDashi API Keys 页面撤销并重新创建。

来源：README.md，提交 6cd274a

工具

0
该服务器需要登录，因此 SourceWeft 无法在没有账号的情况下读取其工具，也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

1
  1. v1.0.2最新Sep 20, 2026

评分

已满足适用检查项的 75%

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

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

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

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

    请在仓库或注册中心条目中声明许可证。