| Name | md2pdf-mcp JSON |
| Version |
0.1.4
JSON |
| download |
| home_page | None |
| Summary | MCP Server for Markdown to PDF conversion |
| upload_time | 2025-10-13 06:17:38 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
conversion
markdown
mcp
pdf
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 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
Raw data
{
"_id": null,
"home_page": null,
"name": "md2pdf-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "conversion, markdown, mcp, pdf",
"author": null,
"author_email": "Chun Liu <chunliu@outlook.com>",
"download_url": "https://files.pythonhosted.org/packages/2d/bd/a3d3cfccec12a570a5789c062a79926de6dcca1893cba2ba71a73a3e55d6/md2pdf_mcp-0.1.4.tar.gz",
"platform": null,
"description": "# md2pdf-mcp\n\nMCP Server for Markdown to PDF conversion.\n\n## Description\n\nThis 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.\n\n## Features\n\n- Convert Markdown text to well-formatted PDF files\n- Random filename generation using UUID to avoid conflicts\n- Configurable output directory via environment variables\n- Returns resource links with metadata for easy integration\n- Built on FastMCP for reliable MCP server functionality\n\n## Installation\n\nYou can install and run this tool using `uvx`:\n\n```bash\nuvx --from md2pdf-mcp md2pdf\n```\n\n## Usage\n\n### As MCP Server\n\nConfigure the server in your MCP client configuration:\n\n```json\n{\n \"mcpServers\": {\n \"md2pdf\": {\n \"command\": \"uvx\",\n \"args\": [\"--from\", \"md2pdf-mcp\", \"md2pdf\"],\n \"env\": {\n \"PDF_OUTPUT_DIR\": \"/path/to/output/folder\"\n }\n }\n }\n}\n```\n\n### Available Tools\n\nThe server provides one tool:\n\n#### `convert_md_to_pdf`\n\nConverts Markdown text to a PDF file.\n\n**Parameters:**\n- `markdown_text` (string): The Markdown content to convert\n\n**Returns:**\nA JSON string containing:\n- `type`: \"resource_link\"\n- `uri`: File URI of the generated PDF\n- `name`: Generated filename (UUID-based)\n- `mimeType`: \"application/pdf\"\n- `annotations`: Metadata including audience, priority, and last modified timestamp\n\n### Environment Variables\n\n- `PDF_OUTPUT_DIR`: Directory where PDF files will be saved (defaults to user's home directory)\n\n### Example Usage\n\nOnce the server is running, you can call the tool through your MCP client:\n\n```json\n{\n \"mcpServers\": {\n \"md2pdf\": {\n \"command\": \"uvx\",\n \"args\": [\"--from\", \"md2pdf-mcp\", \"md2pdf\"],\n \"env\": {\n \"PDF_OUTPUT_DIR\": \"/path/to/output/folder\"\n }\n }\n }\n}\n```\n\n## License\n\nMIT License",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP Server for Markdown to PDF conversion",
"version": "0.1.4",
"project_urls": {
"Homepage": "https://github.com/chunliu/md2pdf",
"Issues": "https://github.com/chunliu/md2pdf/issues",
"Repository": "https://github.com/chunliu/md2pdf"
},
"split_keywords": [
"conversion",
" markdown",
" mcp",
" pdf"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7d3befce0ca45d4c1fbf847c03499139ac99faeb4c13da409db33835de107899",
"md5": "40e5e53f2c2f82d7d2c669a6224218f5",
"sha256": "971b3c089c5d3e856a62eb5ae7935b8b427c78336d2f245b7b452b40bc89c64f"
},
"downloads": -1,
"filename": "md2pdf_mcp-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "40e5e53f2c2f82d7d2c669a6224218f5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 3167,
"upload_time": "2025-10-13T06:17:35",
"upload_time_iso_8601": "2025-10-13T06:17:35.928321Z",
"url": "https://files.pythonhosted.org/packages/7d/3b/efce0ca45d4c1fbf847c03499139ac99faeb4c13da409db33835de107899/md2pdf_mcp-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2dbda3d3cfccec12a570a5789c062a79926de6dcca1893cba2ba71a73a3e55d6",
"md5": "372a4fe5b2564eaf096f87f82d607013",
"sha256": "2c46bef653c4a5297493e57f926c0771356bf1838639846e063806bffc01830a"
},
"downloads": -1,
"filename": "md2pdf_mcp-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "372a4fe5b2564eaf096f87f82d607013",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 160224,
"upload_time": "2025-10-13T06:17:38",
"upload_time_iso_8601": "2025-10-13T06:17:38.556881Z",
"url": "https://files.pythonhosted.org/packages/2d/bd/a3d3cfccec12a570a5789c062a79926de6dcca1893cba2ba71a73a3e55d6/md2pdf_mcp-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-13 06:17:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "chunliu",
"github_project": "md2pdf",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "md2pdf-mcp"
}
