AI导哈

PDF转PNG服务

使用ImageMagick将PDF文件转换为PNG图像（base64编码），以便LLM读取的Model Context Protocol (MCP) 服务器。

  • by Koki-Taniguchi
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 koki-taniguchi/vibe-pdf-read-mcp

使用说明

vibe pdf阅读mcp

ImageMagick来修改标记元素的显示属性PDF打开文件PNG转换为图像（base64）LLM装入Model Context Protocol (MCP) 服务器。

机能

  • PDF打开文件PNG转换为图像（可自定义质量和分辨率）
  • 转换特定页面或所有页面
  • PDF获取文件的总页数
  • Base64轻松集成编码输出
  • AI助手可用MCP遵守协议

所需环境

  • Go 1.24以上
  • ImageMagick

安装

  1. 克隆此存储库：
git clone https://github.com/Koki-Taniguchi/vibe-pdf-read-mcp.git
cd vibe-pdf-read-mcp
  1. 构建可执行文件：
go build -o vibe-pdf-read-mcp
  1. ImageMagick如果未安装，请安装：

ImageMagick网站标题

MCP用作服务器

可用工具

convert_pdf_to_images

PDF打开文件PNG转换为图像。

参数：

  • pdfPath （必需）：转换PDF文件路径
  • density （可选）：分辨率（DPI）（默认值：300）
  • quality （可选）：图像质量1-100（默认值：100）
  • page （可选）：特定页码（从1开始）。0或未指定的所有页面转换

响应：

  • Base64编码PNG图像数据
  • MCP ImageContent返回图像作为类型

get_pdf_page_count

PDF获取文件的总页数。

参数：

  • pdfPath （必需）：PDF文件路径

响应：

  • PDF总页数

设定例

MCP客户端（例如：Claude Desktop）添加到设置：

{
  "mcpServers": {
    "pdf-to-image": {
      "command": "/path/to/vibe-pdf-read-mcp"
    }
  }
}

故障排除

PDF转换失败

  • ImageMagick已安装： convert -version
  • ImageMagick检查安全策略（参见上文）
  • PDF确保文件存在且可读

大的PDF内存问题

  • page使用参数仅转换特定页面
  • density降低参数以降低分辨率
  • PDF批处理

开発者情报

依存关系

源构建

go mod download
go build -o vibe-pdf-read-mcp

运行测试

go test ./...

许可证

这个项目MIT许可证下的许可证-详细信息许可证.md请参见文件。

相关 MCP