Metadata-Version: 2.4
Name: md2pdf-mcp
Version: 0.1.4
Summary: MCP Server for Markdown to PDF conversion
Project-URL: Homepage, https://github.com/chunliu/md2pdf
Project-URL: Repository, https://github.com/chunliu/md2pdf
Project-URL: Issues, https://github.com/chunliu/md2pdf/issues
Author-email: Chun Liu <chunliu@outlook.com>
License: MIT
Keywords: conversion,markdown,mcp,pdf
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: convert-markdown>=0.1.0
Requires-Dist: mcp[cli]>=1.17.0
Description-Content-Type: text/markdown

# md2pdf-mcp

MCP Server for Markdown to PDF conversion.

## Description

This server provides a tool to convert Markdown text to PDF files using the `convert_markdown` library. It's designed to work as an MCP (Model Context Protocol) server that can be integrated with various AI assistants and applications.

## Features

- Convert Markdown text to well-formatted PDF files
- Random filename generation using UUID to avoid conflicts
- Configurable output directory via environment variables
- Returns resource links with metadata for easy integration
- Built on FastMCP for reliable MCP server functionality

## Installation

You can install and run this tool using `uvx`:

```bash
uvx --from md2pdf-mcp md2pdf
```

## Usage

### As MCP Server

Configure the server in your MCP client configuration:

```json
{
    "mcpServers": {
        "md2pdf": {
            "command": "uvx",
            "args": ["--from", "md2pdf-mcp", "md2pdf"],
            "env": {
                "PDF_OUTPUT_DIR": "/path/to/output/folder"
            }
        }
    }
}
```

### Available Tools

The server provides one tool:

#### `convert_md_to_pdf`

Converts Markdown text to a PDF file.

**Parameters:**
- `markdown_text` (string): The Markdown content to convert

**Returns:**
A JSON string containing:
- `type`: "resource_link"
- `uri`: File URI of the generated PDF
- `name`: Generated filename (UUID-based)
- `mimeType`: "application/pdf"
- `annotations`: Metadata including audience, priority, and last modified timestamp

### Environment Variables

- `PDF_OUTPUT_DIR`: Directory where PDF files will be saved (defaults to user's home directory)

### Example Usage

Once the server is running, you can call the tool through your MCP client:

```json
{
    "mcpServers": {
        "md2pdf": {
            "command": "uvx",
            "args": ["--from", "md2pdf-mcp", "md2pdf"],
            "env": {
                "PDF_OUTPUT_DIR": "/path/to/output/folder"
            }
        }
    }
}
```

## License

MIT License