markdown2pdf-mcp

Markdown2PDF MCP 服务器 (markdown2pdf-mcp)

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

受到 Alan Shaw 的markdown-pdf的启发。

特征

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

限制

不支持以下 Markdown 元素：

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

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

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

安装

# Clone the repository
git clone https://github.com/2b3pro/markdown2pdf-mcp.git

# Navigate to the project directory
cd markdown2pdf-mcp

# Install dependencies
npm install

# Build the project
npm run build

用法

启动服务器

npm start

使用 MCP 工具

服务器提供了一个单独的工具create_pdf_from_markdown其参数如下：

{
  // Required parameters
  markdown: string;    // Markdown content to convert

  // Optional parameters with defaults
  outputFilename?: string;  // Filename for the PDF (e.g., "output.pdf")
  paperFormat?: string;     // 'letter' (default), 'a4', 'a3', 'a5', 'legal', 'tabloid'
  paperOrientation?: string; // 'portrait' (default), 'landscape'
  paperBorder?: string;     // '2cm' (default), accepts decimal values with CSS units (e.g., '1.5cm', '2.5mm', '0.5in', '10.5px')
  watermark?: string;       // Optional watermark text (max 15 characters, uppercase)
}

带有选项的示例：

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 设置文件中为使用 MCP 的应用程序（例如 Cline 或 Claude）配置输出目录。如果未配置，则会将文件保存到 $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
卓越- Markdown 解析器
highlights.js - 语法高亮
puppeteer - 使用Chrome 生成现代 PDF 进行测试（v131.0.6778.204）

Chrome 版本

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

tmp——临时文件处理

发展

# Build the project
npm run build

# Start the server
npm start

执照

麻省理工学院

贡献

分叉存储库
创建你的功能分支（ git checkout -b feature/amazing-feature ）
提交您的更改（ git commit -m 'Add some amazing feature' ）
推送到分支（ git push origin feature/amazing-feature ）
打开拉取请求

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

create_pdf_from_markdown

用于将 Markdown 文档转换为 PDF 文件的 MCP 服务器。

Related MCP Servers

mcp-pandoc
vivekVells
A
security
A
license
A
quality
MCP server for seamless document format conversion using Pandoc, supporting Markdown, HTML, PDF, DOCX (.docx), csv and more.
Last updated -
1
338
Python
MIT License
pymupdf4llm-mcp
ai-zerolab
A
security
A
license
A
quality
An MCP server that exports PDF documents to markdown format optimized for LLM processing.
Last updated -
1
1
Python
BSD 3-Clause
markdown2pdf-mcp
Serendipity-AI
A
security
A
license
A
quality
MCP server that converts Markdown to high-quality PDF documents using LaTeX, enabling AI agents like Claude to generate professional PDFs without requiring sign-ups or credit cards.
Last updated -
1
353
7
JavaScript
MIT License
Markdown to HTML MCP Server
1623311678
A
security
F
license
A
quality
An MCP server that converts Markdown to HTML, supporting both stdio and HTTP interfaces for easy integration with Cursor and other MCP clients.
Last updated -
1
3
TypeScript

View all related MCP servers

markdown2pdf-mcp