Markdown2PDF MCP 服务器 (markdown2pdf-mcp)

一个用于将 Markdown 文档转换为 PDF 文件的 MCP 服务器。该服务器提供了一种简单高效的方式，可以从 Markdown 内容生成 PDF，并支持语法高亮和自定义样式。同时允许在第一页添加水印。

灵感来源于 Alan Shaw 的 markdown-pdf。

特性

• 使用单个命令将 Markdown 转换为 PDF
• 代码块的语法高亮
• PDF 输出的自定义 CSS 样式
• 支持标准 Markdown 格式
• 使用 Chrome 渲染引擎生成现代 PDF
• 对现代 Web 特性和字体提供出色的支持
• 可靠的资源加载和渲染

局限性

以下 markdown 元素不受支持：

• LaTeX 数学公式（例如，$x^2$ 或 $$\sum_{i=1}^n x_i$$）
• 复杂的数学公式或科学计数法

请坚持使用以下支持的 markdown 元素：

• 标题（所有级别）
• 文本格式（粗体、斜体、删除线）
• 列表（有序和无序）
• 带有语法高亮的代码块
• 表格
• 块引用
• 链接
• 图像（本地文件和外部 URL）
• 任务列表

安装

# 克隆仓库
git clone https://github.com/2b3pro/markdown2pdf-mcp.git

# 进入项目目录
cd markdown2pdf-mcp

# 安装依赖
npm install

# 构建项目
npm run build

使用

启动服务器

npm start

使用 MCP 工具

服务器提供了一个工具 create_pdf_from_markdown，具有以下参数：

{
  // 必需参数
  markdown: string;    // 要转换的 Markdown 内容

  // 可选参数，带有默认值
  outputFilename?: string;  // PDF 的文件名（例如，“output.pdf”）
  paperFormat?: string;     // 'letter' (默认), 'a4', 'a3', 'a5', 'legal', 'tabloid'
  paperOrientation?: string; // 'portrait' (默认), 'landscape'
  paperBorder?: string;     // '2cm' (默认), 接受带有 CSS 单位的十进制值（例如，“1.5cm”、“2.5mm”、“0.5in”、“10.5px”）
  watermark?: string;       // 可选水印文本（最多 15 个字符，大写）
}

带有选项的示例：

await use_mcp_tool({
  server_name: "markdown2pdf",
  tool_name: "create_pdf_from_markdown",
  arguments: {
    markdown: "# Hello World\n\nThis is a test document.",
    outputFilename: "output.pdf",
    paperFormat: "a4",
    paperOrientation: "landscape",
    paperBorder: "1.5cm",
    watermark: "DRAFT",
  },
});

最小用法的示例：

await use_mcp_tool({
  server_name: "markdown2pdf",
  tool_name: "create_pdf_from_markdown",
  arguments: {
    markdown: "# Hello World\n\nThis is a test document.",
    outputFilename: "output.pdf",
  },
});

配置

输出目录

您可以在使用 MCP 的应用程序（例如 Cline 或 Claude）的 MCP 设置文件中配置输出目录。 如果未配置，它会将文件保存到 $HOME：

{
  "mcpServers": {
    "markdown2pdf": {
      "command": "node",
      "args": ["path/to/markdown2pdf-mcp/build/index.js"],
      "env": {
        "M2P_OUTPUT_DIR": "/path/to/output/directory"
      }
    }
  }
}

该工具会自动处理文件名冲突，方法是附加递增的数字（例如，output.pdf、output-1.pdf、output-2.pdf）。

依赖项

• @modelcontextprotocol/sdk - 用于服务器实现的 MCP SDK
• remarkable - Markdown 解析器
• highlight.js - 语法高亮
• puppeteer - 使用 Chrome for Testing (v131.0.6778.204) 生成现代 PDF

Chrome 版本

此软件包使用 Chrome v131.0.6778.204，以确保所有安装中的 PDF 生成一致。 当您运行 npm install 时，会自动安装此版本。

• tmp - 临时文件处理

开发

# 构建项目
npm run build

# 启动服务器
npm start

许可证

MIT

贡献

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request