AI导哈

PDF视觉分析服务器

一个基于Claude视觉能力的PDF文档分析服务器，支持多会话管理和复杂布局解析。

  • by MIMICLab
  • JavaScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 MIMICLab/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：可选会话标识符

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

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

  3. go_to_page -导航到特定页面

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

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

    • sessionId：会话ID

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

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

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

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

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

    • sessionId：会话ID

  8. 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

相关 MCP