PDF 到 PNG MCP 服务器

一个提供 PDF 转换为 PNG 功能的 Model Context Protocol (MCP) 服务器。此服务器允许您通过简单的 MCP 工具调用将 PDF 文档转换为 PNG 图像。

先决条件

此服务器需要 Model Context Protocol (MCP)。如果您对 MCP 是新手，请从安装 SDK 开始：

uv pip install mcp

额外要求：

• Python 3.10 或更高版本
• uv 包管理器
• poppler（pdf2image 所需）

安装 Poppler

• Windows：从 poppler-windows 下载并安装
• macOS：brew install poppler
• Linux：sudo apt-get install poppler-utils

安装

1. 克隆此仓库：

   git clone https://github.com/truaxki/mcp-Pdf2png.git
   cd mcp-Pdf2png
   

2. 创建并激活虚拟环境：

   uv venv
   # Windows
   .venv\Scripts\activate
   # Unix/macOS
   source .venv/bin/activate
   

3. 安装包：

   uv pip install -e .
   

使用

1. 配置 MCP 客户端

将服务器配置添加到您的 claude_desktop_config.json 文件中。该文件通常位于：

• Windows：%APPDATA%\Claude Desktop\config\claude_desktop_config.json
• macOS/Linux：~/.config/Claude Desktop/config/claude_desktop_config.json

{
  "mcpServers": {
    "pdf2png": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/mcp-Pdf2png",
        "run",
        "pdf2png"
      ]
    }
  }
}

注意：将 /absolute/path/to/mcp-Pdf2png 替换为您实际克隆仓库的路径。

2. 使用服务器

该服务器提供一个工具 pdf2png，带有以下参数：

• read_file_path：输入 PDF 文件的绝对路径
• write_folder_path：PNG 文件保存目录的绝对路径

输出：

• 每个 PDF 页面都会转换为 PNG 图像
• 文件命名为 page_1.png、page_2.png 等
• 返回成功消息和转换数量

贡献

欢迎贡献！请随意提交 Pull Request。