PDF to PNG MCP Server

PDF to PNG MCP Server

site icon
2025.01.07 5
Python文档转换图像处理内容生成
mcp-Pdf2png 是一个基于 Model Context Protocol (MCP) 的服务,提供将 PDF 文档转换为 PNG 图像的功能。通过简单的 MCP 工具调用,用户可以轻松地将 PDF 文件的每一页转换为 PNG 图像。
View on GitHub

Overview

基本能力

产品定位

mcp-Pdf2png 是一个专注于文档格式转换的服务,特别是将 PDF 转换为 PNG 图像。

核心功能

  • 将 PDF 文档转换为 PNG 图像
  • 支持批量转换 PDF 的每一页
  • 通过 MCP 协议提供简单的调用接口

适用场景

  • 需要将 PDF 文档转换为图像格式的场景
  • 批量处理 PDF 文档的每一页为单独的图像文件
  • 集成到自动化工作流中进行文档处理

工具列表

  • pdf2png: 主要工具,用于执行 PDF 到 PNG 的转换
  • 参数:
    • read_file_path: 输入 PDF 文件的绝对路径
    • write_folder_path: 保存 PNG 文件的目录绝对路径
  • 输出:
    • 每个 PDF 页面转换为单独的 PNG 文件
    • 文件命名为 page_1.png, page_2.png
    • 返回包含转换数量的成功消息

常见问题解答

  • 需要安装 poppler 工具来支持 PDF 转换
  • 确保提供正确的绝对路径作为输入和输出参数

使用教程

使用依赖

  1. 安装 MCP SDK:
uv pip install mcp
  1. 安装 poppler:
  2. Windows: 从 poppler-windows 下载安装
  3. macOS:
brew install poppler
  • Linux:
sudo apt-get install poppler-utils

安装教程

  1. 克隆仓库:
git clone https://github.com/truaxki/mcp-Pdf2png.git
cd mcp-Pdf2png
  1. 创建并激活虚拟环境:
uv venv
# Windows
.venv\Scripts\activate
# Unix/macOS
source .venv/bin/activate
  1. 安装包:
uv pip install -e .

调试方式

  1. 配置 MCP 客户端,编辑 claude_desktop_config.json 文件:
{
  "mcpServers": {
    "pdf2png": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/mcp-Pdf2png",
        "run",
        "pdf2png"
      ]
    }
  }
}
  1. 使用工具调用转换功能,确保输入和输出路径正确。

许可证

None