mcp-pdf

本地服务

github.com/mcp-z生产力32 周前更新

代码仓库

关于 mcp-pdf

mcp-pdf 是一个本地 MCP 服务，可创建 PDF 文档和布局、将页面渲染为 PNG，并测量文本。它适用于需要 PDF 生成工具且无需 API 密钥的 MCP 客户端。

主要功能

01生成自动分页的 PDF 文档
02创建精确定位的 PDF 布局
03生成 JSON Resume 文档
04将 PDF 页面渲染为 PNG
05测量布局所需文本尺寸

适用场景

01将连续内容生成 PDF 文档
02制作幻灯片或传单布局
03将 PDF 页面渲染为 PNG 图像
04在排版前测量文本

MCP 相关

向 MCP 客户端提供 PDF 创建、页面渲染和文本测量工具。支持 stdio 和 HTTP 传输。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

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

启动命令npx -y @mcp-z/mcp-pdf

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@mcp-z/mcp-pdf1.0.3stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@mcp-z/mcp-pdf

通过 MCP 创建 PDF 文档和版式、将页面渲染为 PNG，并测量文本。该服务在本地运行，无需 API 密钥。

需要 Node.js >=22.13。示例使用 npx（npm 自带）运行此服务和 @mcp-z/cli。

传输方式

MCP 支持 stdio 和 HTTP。

两种传输方式均支持 2025 和 2026-07-28 协议修订版。2026 修订版为无状态，因此使用该版本的客户端无需发送 initialize 握手或会话 ID。

将以下任一配置保存为 .mcp.json，并放在你要运行命令的目录中。

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 端点为 /mcp。

首次使用

# List tools
npx -y @mcp-z/cli inspect --servers pdf --tools

# Create a simple PDF
npx -y @mcp-z/cli call-tool pdf pdf-document '{"content":[{"type":"text","text":"Hello from MCP"}]}'

该工具会返回生成的 PDF 的文件 URI 和元数据。参数和示例请参阅完整工具参考。

工具摘要

工具	用途
`pdf-document`	自动分页的流式文档
`pdf-layout`	精确定位的版式，例如幻灯片和传单
`pdf-resume`	JSON Resume 文档
`pdf-image`	将 PDF 页面渲染为 PNG
`text-measure`	在排版前测量文本