markdown2pdf-mcp
Markdown2PDF MCP 서버(markdown2pdf-mcp)
마크다운 문서를 PDF 파일로 변환하는 MCP 서버입니다. 이 서버는 구문 강조 및 사용자 지정 스타일을 지원하여 마크다운 콘텐츠에서 PDF를 생성하는 간단하고 효율적인 방법을 제공합니다. 또한 1페이지에 워터마크를 삽입할 수 있습니다.
Alan Shaw의 마크다운-pdf 에서 영감을 얻었습니다.
특징
단일 명령으로 Markdown을 PDF로 변환
코드 블록에 대한 구문 강조 표시
PDF 출력을 위한 사용자 정의 CSS 스타일
표준 마크다운 형식 지원
Chrome의 렌더링 엔진을 사용한 최신 PDF 생성
최신 웹 기능 및 글꼴에 대한 탁월한 지원
안정적인 리소스 로딩 및 렌더링
Related MCP server: MD-PDF MCP Server
제한 사항
다음 마크다운 요소는 지원되지 않습니다.
LaTeX 수학 방정식(예:
$x^2$또는$$\sum_{i=1}^n x_i$$)복잡한 수학 공식이나 과학적 표기법
지원되는 마크다운 요소를 사용하세요.
헤더(모든 레벨)
텍스트 서식(굵게, 기울임꼴, 취소선)
목록(순서가 있는 목록과 순서가 없는 목록)
구문 강조가 있는 코드 블록
테이블
인용구
모래밭
이미지(로컬 파일과 외부 URL 모두)
작업 목록
설치
지엑스피1
용법
서버 시작
npm startMCP 도구 사용
서버는 다음 매개변수를 포함하는 단일 도구 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",
},
});구성
출력 디렉토리
Cline이나 Claude처럼 MCP를 사용하는 앱의 경우, 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
주목할 만한 - 마크다운 파서
highlight.js - 구문 강조
puppeteer - Chrome을 사용한 최신 PDF 생성(테스트용 )(v131.0.6778.204)
크롬 버전
이 패키지는 모든 설치 환경에서 일관된 PDF 생성을 위해 Chrome v131.0.6778.204를 사용합니다. 이 버전은 npm install 실행하면 자동으로 설치됩니다.
tmp - 임시 파일 처리
개발
# Build the project
npm run build
# Start the server
npm start특허
MIT
기여하다
저장소를 포크하세요
기능 브랜치를 생성합니다(
git checkout -b feature/amazing-feature)변경 사항을 커밋하세요(
git commit -m 'Add some amazing feature')브랜치에 푸시(
git push origin feature/amazing-feature)풀 리퀘스트 열기
Available Tools
1 toolcreate_pdf_from_markdownA
Convert markdown content to PDF. Supports basic markdown elements like headers, lists, tables, code blocks, blockquotes, images (both local and external URLs), and Mermaid diagrams. Note: Cannot handle LaTeX math equations. Mermaid syntax errors will be displayed directly in the PDF output.
Inputs: markdown (required), outputFilename, paperBorder, paperFormat, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined and distinct by default.
A single tool inherently has consistent naming, as there are no other tools to compare against. The name 'create_pdf_from_markdown' follows a clear verb_noun pattern.
One tool is too few for a server's purpose, as it severely limits functionality and flexibility. The server's scope (markdown to PDF conversion) could reasonably support additional tools for customization, validation, or batch processing.
The tool surface is severely incomplete for markdown-to-PDF conversion. While the core conversion is covered, there are obvious gaps such as no tools for configuring PDF settings (e.g., margins, page size), handling errors gracefully, or managing multiple conversions efficiently.
Maintenance
Related MCP Connectors
Generate PDF, Word (.docx) and PowerPoint (.pptx) documents from Markdown over MCP.
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
A remote MCP server to convert HTML documents (URL or raw source) to PDF or screenshots
Markdown to PDF: headings, bold, code, lists, rules. A4/Letter/Legal. Free 30/hr. MCP + REST.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that converts PDF files to Markdown format using AI sampling capabilities, supporting both local files and URLs with incremental conversion features.11MIT
- FlicenseAqualityDmaintenanceAn MCP server that enables bidirectional conversion between Markdown and PDF formats, including text extraction from specific pages and metadata retrieval. It supports customizable PDF output sizes and document processing through standard MCP tools.51-
- MIT
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server for converting documents and files to Markdown using Microsoft MarkItDown.MIT