PDF to Markdown

PDF 转 Markdown — MCP 配置

通过我们托管的 Model Context Protocol (MCP) 服务，将 AI 助手连接到 pdf2md——将 PDF 转换为整洁的 Markdown，包含表格和图片。使用 dudko.dev 账号登录一次即可；无需粘贴 API 密钥。

该服务是 pdf2md HTTP API 的入口，并非转换器：文档不会经过模型或服务。助手会发起请求，并在 PDF 所在的位置执行请求。

• 服务： pdf-to-md
• 传输方式： 可流式传输的 HTTP
• URL： https://pdf2md.dudko.dev/mcp
• 身份验证： 通过 auth.dudko.dev 使用 OAuth 2.1——系统会提示你登录。

可以做什么

两个工具，均免费：

工具	功能
api_access	了解 pdf2md API 的工作方式：端点、选项、限制和错误。
api_request	检查转换选项（convert、detect、text），并返回确切的请求信息——URL、标头、curl 命令，以及一个适用于你账号、有效期为 15 分钟的凭证。

---

在 Claude Code 中安装（插件）

/plugin marketplace add dudko-dev/pdf-to-md-mcp-setup
/plugin install pdf-to-md@pdf-to-md
/reload-plugins

然后运行 /mcp，并按提示完成登录。

不想使用市场？直接添加服务：

claude mcp add --transport http pdf-to-md https://pdf2md.dudko.dev/mcp

---

从其他客户端连接

远程 URL 和登录方式相同，只有配置位置不同。

Claude Desktop / claude.ai connectors

1. 打开 设置 → 连接器 → 添加自定义连接器。
2. 名称：PDF to Markdown
3. URL：https://pdf2md.dudko.dev/mcp
4. 保存，然后连接并按提示登录。

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（每个项目）：

{
  "mcpServers": {
    "pdf-to-md": {
      "url": "https://pdf2md.dudko.dev/mcp"
    }
  }
}

VS Code（GitHub Copilot / MCP）及其他客户端

{
  "servers": {
    "pdf-to-md": {
      "type": "http",
      "url": "https://pdf2md.dudko.dev/mcp"
    }
  }
}

---

身份验证

该服务是 OAuth 2.1 资源服务器。首次调用会返回 401，并附带一个 WWW-Authenticate 标头，指向其受保护资源元数据：

• https://pdf2md.dudko.dev/.well-known/oauth-protected-resource/mcp

其中将 https://auth.dudko.dev 指定为授权服务器（范围 usage）。符合规范的 MCP 客户端会自动发现这些信息——你只需要服务 URL，并使用 dudko.dev 账号登录。令牌绑定到受众 https://pdf2md.dudko.dev/mcp，在其他任何位置都会被拒绝。

服务本身不承载任何文件或内容：其工具会返回一个可直接运行的 HTTP 请求，其中包含一个短期有效凭证（有效期 15 分钟，仅适用于此 API），对应于你登录使用的账号。助手会在文件所在的位置执行该请求，API 则直接向调用方返回响应。每个请求都会像其他 API 调用一样计入你账号的套餐用量；MCP 工具本身免费。

---

故障排查

• 401 / 再次提示登录——令牌已过期；请在客户端中重新连接。
• “套餐用量已耗尽” / 402——你账号的转换配额已用完；重试无济于事。请访问 https://auth.dudko.dev/account。
• /convert 返回 422——PDF 是没有文本层的扫描件。pdf2md 不执行 OCR；在消耗转换配额之前，detect 可以告诉你这一点。
• 工具未显示——检查客户端是否已完成登录（Claude Code 中的 /mcp 会显示 已连接）。

支持

• 网站：https://pdf2md.dudko.dev
• API 文档：https://pdf2md.dudko.dev/api
• 面向 Agent：https://pdf2md.dudko.dev/llms.txt
• 联系方式：[email protected]