Markdown转PDF工具

一个基于MCP协议的服务器工具,用于将Markdown文本转换为格式良好的PDF文件,支持随机文件名生成和可配置的输出目录。

  • by chunliu
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 chunliu/md2pdf

使用说明

md2pdf-mcp 翻译为中文是“Markdown转PDF-MCP(可能指特定配置或模块)”。不过,这里的“MCP”具体含义可能需要根据上下文来确定,因为它可能是一个特定项目、配置或模块的缩写。在没有具体上下文的情况下,我们可以将其理解为“Markdown转PDF的某种特定配置或模块(MCP)”

用于Markdown转PDF的MCP服务器。

描述

这台服务器提供了一个工具,用于将Markdown文本转换为PDF文件,使用的是 convert_markdown 该库旨在作为MCP(模型上下文协议)服务器运行,可与各种人工智能助手和应用程序集成。

特点/功能

  • 将Markdown文本转换为格式良好的PDF文件
  • 使用UUID随机生成文件名以避免冲突
  • 通过环境变量配置输出目录
  • 返回带有元数据的资源链接,便于集成
  • 基于FastMCP构建,实现可靠的MCP服务器功能

安装

您可以使用以下方式安装并运行此工具: uvx:

uvx --from md2pdf-mcp md2pdf

使用方法

作为MCP服务器

在您的MCP客户端配置中设置服务器:

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

可用工具

服务器提供了一个工具:

convert_md_to_pdf

将Markdown文本转换为PDF文件。

参数:

  • markdown_text (字符串):要转换的Markdown内容

返回值: 一个包含以下内容的JSON字符串:

  • type“resource_link”翻译为中文是“资源链接”
  • uri生成的PDF文件的文件URI
  • name生成的文件名(基于UUID)
  • mimeType“application/pdf”
  • annotations元数据,包括受众、优先级和最后修改时间戳

环境变量

  • PDF_OUTPUT_DIR保存PDF文件的目录(默认为用户主目录)

示例用法

一旦服务器运行起来,您就可以通过您的MCP客户端调用该工具:

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

许可证

麻省理工学院许可证(MIT License)