pdf-it MCP 服务说明文档

1. 服务概述一句话简介:将Markdown转换为设计精美的PDF文档的MCP服务器,支持封面页、目录、代码块跨页保持、页码页脚服务名称:pdf-it版本号:Latest开发者/提供方:mrslbt (Marsel Bait)协议类型:MCP (Model Context Protocol)2. 核心功能列出该MCP服务提供的主要功能点:Markdown转PDF:一键将Markdown转换为专业设计的PDF封面页生成:自动生成包含标题、作者和日期的封面页目录生成:从H1和H2标题自动生成目录代码块处理:代码块跨页保持,不中断页码页脚:自动添加标题和页码的页脚模板支持:research-report和plain两种模板技能触发:支持save this as PDF等自然语言触发3. 使用场景描述该服务适合在什么情况下使用:研究报告:将Claude Code研究会话转换为专业PDF报告设计文档:创建设计文档和技术规范PDF客户交付:生成可直接发送给客户的PDF文档快速导出:快速将Markdown笔记导出为PDF文档归档:将研究内容保存为PDF格式归档4. 接入方式4.1 服务端点渲染引擎:Google Chrome(Puppeteer)输出目录:~/Documents/pdf-it/(默认)4.2 认证与权限无需认证:本地MCP服务器,无需API密钥Chrome要求:需要安装Google Chrome浏览器Node.js要求:Node.js 18或更新版本4.3 数据格式输入:Markdown格式文本输出:PDF文件,包含:封面页(标题、作者、日期)自动生成的目录正文内容页脚(标题和页码)4.4 服务器配置Claude Desktop配置:{ mcpServers: { pdf-it: { command: npx, args: [-y, pdf-it-mcp] } } }Claude Code配置:claude mcp add pdf-it -- npx -y pdf-it-mcpCursor配置:{ mcpServers: { pdf-it: { command: npx, args: [-y, pdf-it-mcp] } } }5. 接口定义工具列表工具名称描述generate_pdf将Markdown转换为PDF,支持模板、标题、作者和输出路径list_templates返回可用模板列表及其描述generate_pdf参数参数必需描述content是要转换的Markdown字符串title否显示在封面和页脚的标题author否显示在封面的作者output_path否输出文件的绝对路径,默认~/Documents/pdf-it/{slug}-{timestamp}.pdftemplate否模板名称:research-report(默认)或plain模板类型模板名称描述适用场景research-report封面页自动目录正文页脚,完整结构研究、摘要、设计文档、报告plain无封面、无目录,仅正文内容简短笔记、快速导出技能触发短语save this as PDFexport as PDFmake a PDF report from thisturn this into a PDFgenerate a PDF/pdf6. 快速开始6.1 环境要求Node.js 18或更新版本Google Chrome浏览器已安装MCP客户端(Claude Desktop、Claude Code、Cursor等)6.2 示例代码全局安装:npm install -g pdf-it-mcp按需运行:npx pdf-it-mcp自定义Chrome路径:{ mcpServers: { pdf-it: { command: npx, args: [-y, pdf-it-mcp], env: { CHROME_PATH: /path/to/chrome } } } }7. 注意事项Chrome依赖:需要安装Google Chrome作为渲染引擎设计原则:系统字体、Inter正文、JetBrains Mono代码、纯白纸张、近黑墨水、无强调色代码块设计:故意不使用语法高亮,避免PDF中颜色选择过时模板可定制:可分叉src/templates/中的HTML和CSS模板输出路径:默认~/Documents/pdf-it/,可通过output_path参数覆盖许可证:MIT许可证客户端支持:支持Claude Desktop、Claude Code、Cursor、Cline、Continue.dev、Zed、Goose等不支持平台:claude.ai(浏览器)、Claude iOS/Android(移动端不支持本地MCP服务器)