iflow-mcp_truaxki-pdf2png 0.1.0__py3-none-any.whl

iflow_mcp_truaxki_pdf2png-0.1.0.dist-info/METADATA

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_truaxki-pdf2png
+Version: 0.1.0
+Summary: MCP server to convert a PDF to a PNG file.
+Author-email: Kirk Truax <kirktruax93@proton.me>
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: pdf2image>=1.16.3
+Description-Content-Type: text/markdown
+
+# PDF to PNG MCP Server
+
+A Model Context Protocol (MCP) server that provides PDF to PNG conversion capabilities. This server allows you to convert PDF documents into PNG images with a simple MCP tool call.
+
+## Prerequisites
+
+This server requires the Model Context Protocol (MCP). If you're new to MCP, start by installing the SDK:
+```bash
+uv pip install mcp
+```
+
+Additional requirements:
+- Python 3.10 or higher
+- [uv](https://github.com/astral-sh/uv) package manager
+- poppler (required for pdf2image)
+
+### Installing Poppler
+
+- **Windows**: Download and install from [poppler-windows](https://github.com/oschwartz10612/poppler-windows/releases/)
+- **macOS**: `brew install poppler`
+- **Linux**: `sudo apt-get install poppler-utils`
+
+## Installation
+
+1. Clone this repository:
+   ```bash
+   git clone https://github.com/truaxki/mcp-Pdf2png.git
+   cd mcp-Pdf2png
+   ```
+
+2. Create and activate a virtual environment:
+   ```bash
+   uv venv
+   # Windows
+   .venv\Scripts\activate
+   # Unix/macOS
+   source .venv/bin/activate
+   ```
+
+3. Install the package:
+   ```bash
+   uv pip install -e .
+   ```
+
+## Usage
+
+### 1. Configure MCP Client
+
+Add the server configuration to your `claude_desktop_config.json`. The file is typically located in:
+- Windows: `%APPDATA%\Claude Desktop\config\claude_desktop_config.json`
+- macOS/Linux: `~/.config/Claude Desktop/config/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "pdf2png": {
+      "command": "uv",
+      "args": [
+        "--directory",
+        "/absolute/path/to/mcp-Pdf2png",
+        "run",
+        "pdf2png"
+      ]
+    }
+  }
+}
+```
+
+Note: Replace `/absolute/path/to/mcp-Pdf2png` with the actual path where you cloned the repository.
+
+### 2. Using the Server
+
+The server provides a single tool `pdf2png` with these parameters:
+- `read_file_path`: Absolute path to the input PDF file
+- `write_folder_path`: Absolute path to the directory where PNG files should be saved
+
+Output:
+- Each PDF page is converted to a PNG image
+- Files are named `page_1.png`, `page_2.png`, etc.
+- Returns a success message with the conversion count
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

iflow_mcp_truaxki_pdf2png-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+pdf2png/__init__.py,sha256=kS5ZO4LqhqaH6MAaId2CzZAO-kBTmJeVgF25qISeCIw,195
+pdf2png/server.py,sha256=VZb5hxZKi4h2sxtGO2JhosPhmjwO47liHolKPH9IxjQ,2554
+iflow_mcp_truaxki_pdf2png-0.1.0.dist-info/METADATA,sha256=S3ogqPhaxVTsoVkauypZ_MAQHLv4a2FHTRBKhxtc9Pk,2466
+iflow_mcp_truaxki_pdf2png-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+iflow_mcp_truaxki_pdf2png-0.1.0.dist-info/entry_points.txt,sha256=Cs__6PgvxSbLIIKsaNgh5a9q8SqSUmKF75laiLk-UlE,41
+iflow_mcp_truaxki_pdf2png-0.1.0.dist-info/RECORD,,

iflow_mcp_truaxki_pdf2png-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

iflow_mcp_truaxki_pdf2png-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pdf2png = pdf2png:main

pdf2png/__init__.py

@@ -0,0 +1,9 @@
+from . import server
+import asyncio
+
+def main():
+    """Main entry point for the package."""
+    asyncio.run(server.main())
+
+# Expose important items at package level
+__all__ = ['main', 'server']

pdf2png/server.py

@@ -0,0 +1,80 @@
+import asyncio
+from mcp.server.models import InitializationOptions
+import mcp.types as types
+from mcp.server import NotificationOptions, Server
+import mcp.server.stdio
+from pdf2image import convert_from_path
+import os
+
+server = Server("pdf2png")
+
+@server.list_tools()
+async def handle_list_tools() -> list[types.Tool]:
+    """List available tools."""
+    return [
+        types.Tool(
+            name="pdf2png",
+            description="Converts PDFs to images in PNG format.",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "read_file_path": {"type": "string"},
+                    "write_folder_path": {"type": "string"},
+                },
+                "required": ["read_file_path", "write_folder_path"],
+            },
+        )
+    ]
+
+@server.call_tool()
+async def handle_call_tool(
+    name: str, arguments: dict | None
+) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
+    """Handle tool execution requests."""
+    if name != "pdf2png":
+        raise ValueError(f"Unknown tool: {name}")
+
+    if not arguments:
+        raise ValueError("Missing arguments")
+
+    read_file_path = arguments.get("read_file_path")
+    write_folder_path = arguments.get("write_folder_path")
+
+    if not read_file_path or not write_folder_path:
+        raise ValueError("Missing read_file_path or write_folder_path")
+
+    # Convert PDF to PNG
+    images = convert_from_path(read_file_path)
+    
+    # Create output directory if it doesn't exist
+    os.makedirs(write_folder_path, exist_ok=True)
+    
+    # Save each page as PNG
+    output_files = []
+    for i, image in enumerate(images):
+        output_path = os.path.join(write_folder_path, f'page_{i+1}.png')
+        image.save(output_path, 'PNG')
+        output_files.append(output_path)
+
+    return [
+        types.TextContent(
+            type="text",
+            text=f"Successfully converted PDF to {len(output_files)} PNG files in {write_folder_path}"
+        )
+    ]
+
+async def main():
+    # Run the server using stdin/stdout streams
+    async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
+        await server.run(
+            read_stream,
+            write_stream,
+            InitializationOptions(
+                server_name="pdf2png",
+                server_version="0.1.0",
+                capabilities=server.get_capabilities(
+                    notification_options=NotificationOptions(),
+                    experimental_capabilities={},
+                ),
+            ),
+        )