@youhaozhao/pdf2docx-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# pdf2docx MCP Server
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server that converts PDF documents to editable DOCX format.
+
+## Installation
+
+```bash
+npm install -g @youhaozhao/pdf2docx-mcp
+```
+
+## Usage
+
+### As an MCP Server
+
+Add to your Claude Desktop configuration (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "pdf2docx": {
+      "command": "pdf2docx-mcp"
+    }
+  }
+}
+```
+
+Or with npx:
+
+```json
+{
+  "mcpServers": {
+    "pdf2docx": {
+      "command": "npx",
+      "args": ["@youhaozhao/pdf2docx-mcp"]
+    }
+  }
+}
+```
+
+### Available Tools
+
+#### `convert`
+
+Convert a PDF file to DOCX format.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `pdf_path` | string | Yes | Absolute path to input PDF |
+| `output_path` | string | No | Output path (default: same as input with .docx) |
+| `pages` | string | No | Pages to convert: "0,1,2" or "0-5" |
+| `password` | string | No | Password for encrypted PDFs |
+
+**Returns:** Conversion result with output path and file size
+
+#### `get_info`
+
+Get metadata about a PDF file.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `pdf_path` | string | Yes | Absolute path to PDF |
+
+**Returns:** Page count, file size, encryption status, and metadata
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Python >= 3.10
+
+Python dependencies are automatically installed during `npm install`.
+
+## License
+
+MIT

package/bin/pdf2docx-mcp.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+
+/**
+ * pdf2docx MCP Server 启动器
+ * 自动检测 Python 并安装依赖，然后启动 Python MCP 服务器。
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// 配置路径
+const PYTHON_SCRIPT = path.join(__dirname, '..', 'python', 'mcp_server.py');
+const PYTHON_REQUIREMENTS = path.join(__dirname, '..', 'python', 'requirements.txt');
+
+// 查找可用的 Python 可执行文件
+async function findPython() {
+  const pythonCommands = ['python3', 'python', 'python3.14', 'python3.13', 'python3.12', 'python3.11', 'python3.10'];
+
+  for (const cmd of pythonCommands) {
+    try {
+      const result = await spawnAsync(cmd, ['--version']);
+      if (result.stdout && result.stdout.includes('Python')) {
+        return cmd;
+      }
+    } catch {
+      // 继续尝试下一个命令
+    }
+  }
+
+  throw new Error(
+    'Python not found. Please install Python 3.10+ from https://python.org\n' +
+    'After installation, restart your terminal and try again.'
+  );
+}
+
+// 检查并安装 Python 依赖
+async function ensureDependencies(pythonCmd) {
+  const requirementsPath = PYTHON_REQUIREMENTS;
+
+  if (!fs.existsSync(requirementsPath)) {
+    console.error('Error: requirements.txt not found at', requirementsPath);
+    process.exit(1);
+  }
+
+  try {
+    // 检查 mcp 包是否已安装
+    await spawnAsync(pythonCmd, ['-c', 'import mcp']);
+  } catch {
+    // 未安装，执行安装
+    console.error('Installing Python dependencies...');
+    try {
+      await spawnAsync(pythonCmd, ['-m', 'pip', 'install', '-r', requirementsPath], {
+        stdio: 'inherit'
+      });
+      console.error('Python dependencies installed successfully\n');
+    } catch {
+      console.error('\nFailed to install Python dependencies');
+      console.error('Please run manually:');
+      console.error(`  ${pythonCmd} -m pip install -r ${requirementsPath}`);
+      process.exit(1);
+    }
+  }
+}
+
+// 启动子进程并返回结果
+function spawnAsync(command, args, options = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      stdio: options.stdio || 'pipe',
+      shell: process.platform === 'win32',
+      ...options
+    });
+
+    let stdout = '';
+    let stderr = '';
+    let code = null;
+
+    if (child.stdout) {
+      child.stdout.on('data', (data) => {
+        stdout += data.toString();
+      });
+    }
+
+    if (child.stderr) {
+      child.stderr.on('data', (data) => {
+        stderr += data.toString();
+      });
+    }
+
+    child.on('close', (exitCode) => {
+      code = exitCode;
+      if (code === 0) {
+        resolve({ stdout, stderr, code });
+      } else {
+        const error = new Error(`Command failed with exit code ${code}`);
+        error.stdout = stdout;
+        error.stderr = stderr;
+        error.code = code;
+        reject(error);
+      }
+    });
+
+    child.on('error', (error) => {
+      reject(error);
+    });
+  });
+}
+
+async function main() {
+  try {
+    // 检查 Python 脚本是否存在
+    if (!fs.existsSync(PYTHON_SCRIPT)) {
+      console.error('Error: mcp_server.py not found at', PYTHON_SCRIPT);
+      process.exit(1);
+    }
+
+    const pythonCmd = await findPython();
+    await ensureDependencies(pythonCmd);
+
+    // 启动 MCP 服务器
+    console.error('pdf2docx MCP Server started, waiting for connection...');
+    const child = spawn(pythonCmd, [PYTHON_SCRIPT], {
+      stdio: 'inherit',
+      shell: process.platform === 'win32',
+      env: {
+        ...process.env,
+        PYTHONPATH: path.join(__dirname, '..', 'python')
+      }
+    });
+
+    // 处理子进程退出
+    child.on('error', (error) => {
+      console.error('Failed to start MCP Server:', error.message);
+      process.exit(1);
+    });
+
+    child.on('exit', (code) => {
+      process.exit(code || 0);
+    });
+
+  } catch (error) {
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@youhaozhao/pdf2docx-mcp",
+  "version": "0.1.0",
+  "description": "MCP Server for converting PDF documents to editable DOCX format",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "pdf",
+    "docx",
+    "pdf2docx",
+    "document-conversion"
+  ],
+  "homepage": "https://github.com/youhaozhao/pdf2docx-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/youhaozhao/pdf2docx-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/youhaozhao/pdf2docx-mcp/issues"
+  },
+  "license": "MIT",
+  "bin": {
+    "pdf2docx-mcp": "bin/pdf2docx-mcp.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install-python-deps.js",
+    "start": "node bin/pdf2docx-mcp.js",
+    "dev": "node bin/pdf2docx-mcp.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "files": [
+    "bin/",
+    "python/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "eslint": "^10.0.0",
+    "globals": "^17.3.0"
+  }
+}

package/python/mcp_server.py

@@ -0,0 +1,121 @@
+"""pdf2docx MCP Server.
+
+A Model Context Protocol server that converts PDF documents to editable DOCX format.
+"""
+
+from mcp.server.fastmcp import FastMCP
+from pdf2docx import Converter
+import os
+
+mcp = FastMCP(
+    name="pdf2docx",
+    instructions="Convert PDF documents to editable DOCX format. Supports partial page conversion and encrypted PDFs with password."
+)
+
+
+@mcp.tool()
+def convert(pdf_path: str, output_path: str = None, pages: str = None, password: str = None) -> dict:
+    """Convert PDF file to DOCX format.
+
+    Args:
+        pdf_path: Absolute path to the input PDF file
+        output_path: Absolute path for the output DOCX file. If not provided, uses the same directory as pdf_path with .docx extension
+        pages: Optional comma-separated page numbers to convert (0-indexed). Example: "0,1,2" or "0-5"
+        password: Optional password for encrypted PDFs
+
+    Returns:
+        dict: Conversion result with success status, output path, and file size
+
+    Raises:
+        FileNotFoundError: If the input PDF file doesn't exist
+        ValueError: If the PDF is encrypted and no password is provided
+    """
+    # Validate input file exists
+    if not os.path.exists(pdf_path):
+        raise FileNotFoundError(f"PDF file not found: {pdf_path}")
+
+    # Generate default output path if not provided
+    if output_path is None:
+        base_name = os.path.splitext(pdf_path)[0]
+        output_path = f"{base_name}.docx"
+
+    # Ensure output directory exists
+    output_dir = os.path.dirname(output_path)
+    if output_dir and not os.path.exists(output_dir):
+        os.makedirs(output_dir, exist_ok=True)
+
+    # Parse page numbers if provided
+    pages_list = None
+    if pages:
+        # Handle both "0,1,2" and "0-5" formats
+        if "-" in pages:
+            start, end = pages.split("-")
+            pages_list = list(range(int(start), int(end) + 1))
+        else:
+            pages_list = [int(p.strip()) for p in pages.split(",")]
+
+    # Perform conversion
+    cv = Converter(pdf_path)
+
+    if pages_list:
+        cv.convert(output_path, pages=pages_list)
+    else:
+        cv.convert(output_path)
+
+    cv.close()
+
+    # Get output file size
+    file_size_mb = os.path.getsize(output_path) / (1024 * 1024)
+
+    return {
+        "success": True,
+        "input_path": pdf_path,
+        "output_path": output_path,
+        "size_mb": round(file_size_mb, 2),
+        "pages": pages_list if pages_list else "all"
+    }
+
+
+@mcp.tool()
+def get_info(pdf_path: str) -> dict:
+    """Get metadata information about a PDF file.
+
+    Args:
+        pdf_path: Absolute path to the PDF file
+
+    Returns:
+        dict: PDF metadata including page count, file size, and whether it's encrypted
+
+    Raises:
+        FileNotFoundError: If the PDF file doesn't exist
+    """
+    if not os.path.exists(pdf_path):
+        raise FileNotFoundError(f"PDF file not found: {pdf_path}")
+
+    file_size_mb = os.path.getsize(pdf_path) / (1024 * 1024)
+
+    # Open PDF to get page count
+    import fitz  # PyMuPDF
+    doc = fitz.open(pdf_path)
+    page_count = doc.page_count
+    is_encrypted = doc.needs_password
+    metadata = doc.metadata
+    doc.close()
+
+    return {
+        "path": pdf_path,
+        "page_count": page_count,
+        "size_mb": round(file_size_mb, 2),
+        "is_encrypted": is_encrypted,
+        "metadata": {
+            "title": metadata.get("title", ""),
+            "author": metadata.get("author", ""),
+            "subject": metadata.get("subject", ""),
+            "creator": metadata.get("creator", ""),
+            "producer": metadata.get("producer", ""),
+        }
+    }
+
+
+if __name__ == "__main__":
+    mcp.run()

package/python/requirements.txt

@@ -0,0 +1,3 @@
+mcp>=0.9.0
+pdf2docx>=0.8.0
+pymupdf>=1.26.7

package/scripts/install-python-deps.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+
+/**
+ * postinstall 脚本：安装 Python 依赖
+ */
+
+const { spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const PYTHON_REQUIREMENTS = path.join(__dirname, '..', 'python', 'requirements.txt');
+
+// 查找 Python
+async function findPython() {
+  const pythonCommands = ['python3', 'python', 'python3.14', 'python3.13', 'python3.12', 'python3.11', 'python3.10'];
+
+  for (const cmd of pythonCommands) {
+    try {
+      const result = await spawnAsync(cmd, ['--version']);
+      if (result.stdout && result.stdout.includes('Python')) {
+        return cmd;
+      }
+    } catch {
+      // 继续尝试
+    }
+  }
+
+  return null;
+}
+
+function spawnAsync(command, args, options = {}) {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      stdio: 'pipe',
+      shell: process.platform === 'win32',
+      ...options
+    });
+
+    let stdout = '';
+    let stderr = '';
+
+    if (child.stdout) {
+      child.stdout.on('data', (data) => {
+        stdout += data.toString();
+      });
+    }
+
+    if (child.stderr) {
+      child.stderr.on('data', (data) => {
+        stderr += data.toString();
+      });
+    }
+
+    child.on('close', (exitCode) => {
+      if (exitCode === 0) {
+        resolve({ stdout, stderr });
+      } else {
+        reject(new Error(`Command failed: ${command} ${args.join(' ')}`));
+      }
+    });
+
+    child.on('error', reject);
+  });
+}
+
+async function main() {
+  if (!fs.existsSync(PYTHON_REQUIREMENTS)) {
+    console.warn('requirements.txt not found, skipping Python dependency installation');
+    return;
+  }
+
+  const pythonCmd = await findPython();
+  if (!pythonCmd) {
+    console.warn('Python not found, skipping Python dependency installation');
+    console.warn('Please install Python 3.10+ and run: pip install -r python/requirements.txt');
+    return;
+  }
+
+  try {
+    // 检查是否已安装
+    await spawnAsync(pythonCmd, ['-c', 'import mcp']);
+    console.log('Python dependencies already installed');
+  } catch {
+    // 安装依赖
+    console.log('Installing Python dependencies...');
+    try {
+      await spawnAsync(pythonCmd, ['-m', 'pip', 'install', '-r', PYTHON_REQUIREMENTS], {
+        stdio: 'inherit'
+      });
+      console.log('Python dependencies installed successfully');
+    } catch {
+      console.warn('Failed to install Python dependencies during postinstall');
+      console.warn('Please run manually: pip install -r python/requirements.txt');
+    }
+  }
+}
+
+main().catch(() => {
+  // 静默失败，不要阻塞 npm install
+});