Server Pdf

🚀 @mcp-z/mcp-pdf

@mcp-z/mcp-pdf 是一個用於生成 PDF 的 MCP 服務器，支持文檔、佈局和圖像導出。它提供了多種工具，可滿足不同的 PDF 生成需求。

文檔鏈接：https://mcp-z.github.io/mcp-pdf

🚀 快速開始

安裝

MCP 支持標準輸入輸出（stdio）和 HTTP 兩種傳輸方式，以下是對應的配置示例：

Stdio

{
  "mcpServers": {
    "pdf": {
      "command": "npx",
      "args": ["-y", "@mcp-z/mcp-pdf"]
    }
  }
}

HTTP

{
  "mcpServers": {
    "pdf": {
      "type": "http",
      "url": "http://localhost:9010/mcp",
      "start": {
        "command": "npx",
        "args": ["-y", "@mcp-z/mcp-pdf", "--port=9010"]
      }
    }
  }
}

start 是 npx @mcp-z/cli up 用於啟動 HTTP 服務器的擴展。

使用示例

# 列出可用工具
mcp-z inspect --servers pdf --tools

# 創建一個簡單的 PDF
mcp-z call pdf pdf-document '{"content":["Hello from MCP"]}'

✨ 主要特性

• PDF 生成：可從文本或佈局生成 PDF。
• 圖像渲染：將 PDF 頁面渲染為圖像。
• 文本測量：在佈局前測量文本的寬度和高度。

💻 使用示例

pdf-resume

該工具可從 JSON Resume 格式生成專業簡歷。

// 示例：自定義簡歷部分順序
await client.callTool('pdf-resume', {
  resume: { /* JSON Resume 數據 */ },
  sections: {
    sections: [
      { source: 'basics', render: 'header' },
      { source: 'basics.summary', title: 'Summary' },
      { source: 'work', title: 'Experience' },
      { source: 'skills', title: 'Skills' },
      { source: 'education', title: 'Education' }
    ]
  }
});

pdf-layout

該工具可創建具有精確定位和 Yoga 彈性佈局的 PDF。

// 示例：創建一個兩列布局的 PDF
await client.callTool('pdf-layout', {
  pageSetup: { backgroundColor: '#fffef5' },
  content: [
    { type: 'heading', text: 'SUMMER FESTIVAL 2024', align: 'center', fontSize: 28, y: 50 },
    { type: 'text', text: 'July 15-17 | Central Park', align: 'center', y: 90 },
    {
      type: 'group',
      direction: 'row',
      gap: 20,
      x: 54,
      y: 130,
      children: [
        {
          type: 'group',
          flex: 1,
          border: { color: '#2196f3', width: 2 },
          padding: 15,
          children: [
            { type: 'heading', text: 'MUSIC', align: 'center', fontSize: 18 },
            { type: 'text', text: 'Live bands all weekend' },
            { type: 'text', text: '- Main Stage' },
            { type: 'text', text: '- Acoustic Tent' }
          ]
        },
        {
          type: 'group',
          flex: 1,
          border: { color: '#4caf50', width: 2 },
          padding: 15,
          children: [
            { type: 'heading', text: 'FOOD', align: 'center', fontSize: 18 },
            { type: 'text', text: '50+ local vendors' },
            { type: 'text', text: '- Food Court' },
            { type: 'text', text: '- Craft Beers' }
          ]
        }
      ]
    },
    {
      type: 'group',
      width: 300,
      align: 'center',
      y: 400,
      border: { color: '#ff9800', width: 2 },
      padding: 15,
      background: '#fff8e1',
      children: [
        { type: 'heading', text: 'TICKETS', align: 'center', fontSize: 16 },
        { type: 'text', text: 'Early Bird: $25', align: 'center' },
        { type: 'text', text: 'At Door: $35', align: 'center' }
      ]
    }
  ]
});

📚 詳細文檔

可用工具

pdf-resume

從 JSON Resume 格式生成專業簡歷。

參數說明：

簡歷模式部分：

• basics - 姓名、聯繫方式、摘要、所在地
• work - 工作經歷及亮點
• education - 學位和院校
• projects - 個人/專業項目
• skills - 按類別分組的技能
• awards, certificates, languages, volunteer, publications, interests, references

pdf-layout

創建具有精確定位和 Yoga 彈性佈局的 PDF。

參數說明：

pdf-document

創建具有自動分頁功能的流式 PDF 文檔。

pdf-image

將 PDF 頁面渲染為 PNG 圖像，用於預覽或導出。

text-measure

在佈局前測量文本的寬度和高度。

外部資源

• PDFKit 文檔
• JSON Resume 模式
• JSON Resume 編輯器

提示

1. resource-fetching：資源獲取相關提示。

🔧 技術細節

傳輸方式

MCP 支持標準輸入輸出（stdio）和 HTTP 兩種傳輸方式，可根據實際需求選擇合適的方式進行配置。

工具實現

各個工具（如 pdf-resume、pdf-layout 等）都有其特定的參數和使用方式，通過傳入不同的參數可以實現不同的功能。例如，pdf-resume 工具通過傳入 resume 參數來指定簡歷數據，通過 sections 參數來控制簡歷部分的顯示順序和格式。

佈局引擎

pdf-layout 工具使用 Yoga 彈性佈局引擎，通過 type: 'group' 創建彈性容器，支持多種佈局模式，如兩列布局、三列布局等。同時，該工具還支持精確的定位和混合定位，可滿足不同的佈局需求。

文本處理

支持 Emoji 和 Unicode 文本，Emoji 以嵌入式圖像的形式渲染，Unicode 文本在主要腳本中都能正常顯示。同時，提供了 text-measure 工具，可在佈局前測量文本的寬度和高度，方便進行佈局調整。