MCP Pdf2png

🚀 PDF 到 PNG MCP 服務器

本項目是一個模型上下文協議（MCP）服務器，可將 PDF 文檔轉換為 PNG 圖像。通過簡單的 MCP 工具調用，就能輕鬆完成轉換，為處理 PDF 文件提供了便利。

🚀 快速開始

先決條件

此服務器依賴模型上下文協議（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 等
• 返回一個成功消息，顯示轉換數量

✨ 主要特性

• 基於模型上下文協議（MCP），通過簡單調用即可實現 PDF 到 PNG 的轉換。
• 支持多平臺安裝，包括 Windows、macOS 和 Linux。
• 可配置的 MCP 客戶端，方便集成到現有系統中。

🤝 貢獻

歡迎貢獻！請隨時提交 Pull Request。