Foliopdf

FolioPDF MCP 服务

为 AI Agent 提供 PDF 生成、处理和提取功能。单个二进制文件，本地渲染，可离线使用。

安装

Homebrew

brew install foliopdf/tap/foliopdf-mcp

Go

go install github.com/foliopdf/foliopdf-mcp@latest

直接下载

# macOS (Apple Silicon)
curl -L https://github.com/foliopdf/foliopdf-mcp/releases/latest/download/foliopdf-mcp-darwin-arm64.tar.gz | tar xz
sudo mv foliopdf-mcp /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/foliopdf/foliopdf-mcp/releases/latest/download/foliopdf-mcp-darwin-amd64.tar.gz | tar xz
sudo mv foliopdf-mcp /usr/local/bin/

# Linux
curl -L https://github.com/foliopdf/foliopdf-mcp/releases/latest/download/foliopdf-mcp-linux-amd64.tar.gz | tar xz
sudo mv foliopdf-mcp /usr/local/bin/

设置

添加到 Claude Desktop（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "foliopdf": {
      "command": "foliopdf-mcp"
    }
  }
}

重启 Claude Desktop，让它生成一个 PDF。

工具

工具	功能
render_html	将 HTML 转为 PDF，支持 Tailwind CSS v3、页眉/页脚和模板变量
render_markdown	将 Markdown 转为 PDF，支持主题和语法高亮
manipulate_pdf	合并、拆分或旋转 PDF
extract_pdf	从 PDF 中提取文本和元数据

每条响应都包含 PDF 的 base64 数据和本地文件路径。

功能

Tailwind CSS v3

设置 tailwind: true。完整样式表已打包到二进制文件中，可离线使用。

{"html": "<div class='bg-blue-500 text-white p-8'>Hello</div>", "tailwind": true}

不支持 Tailwind v4。

内置字体

Inter 和 Geist 已嵌入二进制文件。无需任何设置，即可在 CSS 中使用：

body { font-family: 'Inter', sans-serif; }
h1 { font-family: 'Geist', sans-serif; }

两种字体均包含常规、粗体、斜体和粗斜体字重。

模板变量

HTML 和 Markdown 均支持 Go html/template 语法：

{
  "html": "<h1>Invoice for {{.company}}</h1><p>Amount: {{.amount}}</p>",
  "data": {"company": "Acme Corp", "amount": "$1,234"}
}

支持 {{.variable}}、{{range .items}}...{{end}}、{{if .condition}}...{{end}}。

页眉和页脚

在每一页重复显示内容。使用 <span class='pageNumber'></span> 和 <span class='totalPages'></span> 显示页码。

{
  "header_html": "<div style='text-align:right;font-size:10px'>{{.company}}</div>",
  "footer_html": "<div style='text-align:center;font-size:9px'>Page <span class='pageNumber'></span> of <span class='totalPages'></span></div>"
}

Markdown 主题

render_markdown 内置三种主题：

• github — 简洁的无衬线字体、彩色链接和代码背景
• minimal — 衬线字体排版，最大限度提升可读性
• print — 正式版式、两端对齐文本，针对打印优化

水印

在每一页叠加对角文本：

{"watermark": "DRAFT"}

开发

go build ./...
go test ./...
./foliopdf-mcp --version

许可证

MIT