Pd Fmd MCP

PDF到Markdown MCP服务器

 ](https://nodejs.org/)  

一种模型上下文协议（MCP）服务器，使用Qwen VL视觉模型将PDF页面转换为markdown格式。

特性

• 将PDF转换为Markdown：从任何PDF页面提取文本、表格和文档结构。
• 视觉驱动的准确性：使用AI视觉（Qwen VL）进行高保真提取，这是常规文本解析器经常错过的。
• 易于集成：适用于任何MCP客户端，如Claude Desktop。

需求

• Node.js：版本18或更高版本。
• Qwen VL API访问：API密钥和对Qwen VL端点的访问。

安装和配置

1.安装依赖项

npm install
npm run build

2.环境变量

服务器需要以下环境变量：

• QWEN_API_URL：端点URL（例如。， https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions)
• QWEN_API_KEY：您的身份验证密钥。
• QWEN_MODEL：特定型号名称（默认为 Qwen3-VL-235B-A22B-Instruct).
• VLLM_REASONING_PARSER （可选）：当您通过vLLM为推理模型提供服务并且需要禁用思维时，请将其设置为 kimi_k2 Kimi K2.x或 qwen3 对于Qwen3。服务器将发送匹配结果 chat_template_kwargs 预计vLLM。
• WORKSPACE （可选）：以逗号分隔的绝对目录路径列表。设置后，服务器将仅处理位于这些目录中的PDF文件，防止访问允许工作区之外的文件。

运行时和测试脚本会自动在本地加载项目 .env 如果存在文件，则可以将这些值保存在 .env 而不是在shell中导出它们。

3.使用Claude Desktop进行设置

将此添加到您的Claude Desktop配置文件中：

{
  "mcpServers": {
    "pdf-to-markdown": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-to-markdown-mcp"
      ],
      "env": {
        "QWEN_API_URL": "https://your-qwen-api-endpoint.com/v1/chat/completions",
        "QWEN_API_KEY": "your-api-key-here",
        "QWEN_MODEL": "Qwen3-VL-235B-A22B-Instruct"
      }
    }
  }
}

vLLM推理模型

如果您的OpenAI兼容端点由vLLM提供支持，并且所服务的模型默认为思维模式，请配置解析器，以便服务器可以正确禁用它：

• VLLM_REASONING_PARSER=kimi_k2 发送 chat_template_kwargs: { "thinking": false }
• VLLM_REASONING_PARSER=qwen3 发送 chat_template_kwargs: { "enable_thinking": false }

Kimi K2.x至vLLM的MCP配置示例：

{
  "mcpServers": {
    "pdf-to-markdown": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-to-markdown-mcp"
      ],
      "env": {
        "QWEN_API_URL": "http://your-vllm-host:8000/v1/chat/completions",
        "QWEN_API_KEY": "EMPTY",
        "QWEN_MODEL": "moonshotai/Kimi-K2.6-Vision-Instruct",
        "VLLM_REASONING_PARSER": "kimi_k2"
      }
    }
  }
}

用法

连接后，您可以使用 convert_pdf_page_to_markdown 工具。

工具： convert_pdf_page_to_markdown

将特定页面从PDF文件转换为markdown。

论据：

• pdf_path （string）：计算机上PDF文件的绝对路径。
• page_number （number）：要转换的页码（从1开始）。

示例提示：

“请帮我将C:\\Documents\\Report.pdf的第5页转换为markdown。”

系统依赖

根据您的操作系统，您可能需要额外的库来渲染PDF：

• 视窗：不需要额外的步骤。
• macOS: brew install pkg-config cairo pango libpng jpeg giflib librsvg
• Linux（Ubuntu/Debian）: sudo apt-get install build-essential libcairo2-dev libpango1.0-dev libjpeg-dev libgif-dev librsvg2-dev

故障排除

• “找不到PDF文件”：确保路径是绝对的，并且文件是可访问的。
• “页码无效”：检查文档中是否存在页码。
• API错误：验证您的 QWEN_API_URL 和 QWEN_API_KEY 在 .env 或者你的shell环境。
• 渲染失败：如果在Linux/macOS上转换失败，请确保 系统依赖 上面安装。

许可证

Apache 2.0