MCP Pdf Vision

MCP PDF视觉服务器

一种模型上下文协议（MCP）服务器，使Claude能够使用其视觉功能分析PDF文档。

特性

• 📄 使用Claude的视觉功能进行直接PDF分析
• 📑 多会话支持处理多个PDF
• 🔍 逐页导航和分析
• 📊 提取和分析单个页面或页面范围
• 🖼️ 适用于复杂的布局、表格、图表和扫描的PDF

安装

选项1:NPM（推荐）

npm install -g mcp-pdf-vision
claude mcp add pdf-vision --scope user -- npx mcp-pdf-vision

选项2：手动安装

git clone https://github.com/MIMICLab/mcp-pdf-vision.git
cd mcp-pdf-vision
npm install
npm run build
claude mcp add pdf-vision --scope user -- node $(pwd)/dist/index.js

选项3：快速安装脚本

curl -sSL https://raw.githubusercontent.com/MIMICLab/mcp-pdf-vision/main/install.sh | bash

Claude代码中的用法

验证安装

claude mcp list
# Should show: pdf-vision ✓ Connected

基本命令

# Load a PDF
"Load /path/to/document.pdf using pdf-vision"

# View current page
"Show me the current page"

# Navigate pages
"Go to next page"
"Go to page 5"

# Analyze content
"Analyze the table on this page"
"Summarize pages 1-5"

可用工具

1. load_pdf -加载PDF文件进行分析

- pdfPath：PDF文件的路径 - sessionId：可选会话标识符

1. get_current_page -将当前页面作为图像获取

- sessionId：加载的PDF的会话ID - dpi：图像提取分辨率（默认值：150）

1. go_to_page -导航到特定页面

- sessionId：会话ID - pageNumber：目标页码（1-索引）

1. 下一页 / 上一页_页 -在页面之间导航

- sessionId：会话ID

1. get_pages_range -一次获取多个页面

- sessionId：会话ID - startPage：起始页码 - endPage：结束页码 - dpi：分辨率（默认值：150）

1. 获取所有页面 -从PDF中获取所有页面

- sessionId：会话ID - dpi：分辨率（默认值：150）

1. get_pdf_info -获取有关加载的PDF的信息

- sessionId：会话ID

1. list_sessions -列出所有活动的PDF会话

配置

克劳德代码（CLI）

通过npm或安装脚本安装时，服务器会自动配置。

手动配置 ~/.claude.json:

{
  "mcpServers": {
    "pdf-vision": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/mcp-pdf-vision/dist/index.js"]
    }
  }
}

克劳德桌面应用程序

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "pdf-vision": {
      "command": "npx",
      "args": ["mcp-pdf-vision"]
    }
  }
}

发展

# Clone the repository
git clone https://github.com/MIMICLab/mcp-pdf-vision.git
cd mcp-pdf-vision

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build TypeScript
npm run build

# Test locally
claude mcp add pdf-vision-dev --scope project -- node $(pwd)/dist/index.js

故障排除

服务器未出现在 /mcp 列表

1. 完全重新启动Claude代码
2. 检查服务器状态： claude mcp list
3. 重新安装： npm uninstall -g mcp-pdf-vision && npm install -g mcp-pdf-vision

PDF加载错误

• 确保PDF路径是绝对的，而不是相对的
• 检查文件权限
• 验证PDF是否已损坏

贡献

欢迎投稿！请随时提交拉取请求。

许可证

麻省理工学院

作者

金泰勋- MIMICLab