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。