JinDaGe - PDF to PNG MCP Details

article

README

🚀 PDF 到 PNG MCP 服务器

这是一个基于 Model Context Protocol (MCP) 的服务器，专门用于将 PDF 文档转换为 PNG 图像。借助简单的 MCP 工具调用，就能轻松完成转换，为您的工作带来极大便利。

🚀 快速开始

此服务器需要 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

📦 安装指南

克隆此仓库：

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

创建并激活虚拟环境：

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

安装包：
```
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 等
返回成功消息和转换数量

✨ 主要特性

提供简单的 MCP 工具调用方式，方便快捷地将 PDF 转换为 PNG 图像。
支持多平台，包括 Windows、macOS 和 Linux。

🤝 贡献

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

PDF to PNG