PDF阅读器MCP服务器

这是一个使用Google的Gemini API来读取和分析PDF文档的Model Context Protocol (MCP)服务器，用Go编写。此服务器使像Claude（代码和桌面）和Cursor这样的AI助手能够无缝地从它们的界面中读取、提取和分析PDF内容。

描述

PDF阅读器MCP服务器作为AI助手与PDF文档之间的桥梁，允许它们：

1. 使用pdf_read工具从PDF文件中读取和提取文本
2. 使用pdf_analyze工具利用Gemini的强大视觉能力分析PDF内容
3. 使用pdf_search工具在PDF文档中搜索特定信息

这种集成让像Claude这样的AI助手能够在不离开其界面的情况下访问和理解PDF内容，从而创建一个流畅的文档分析和信息提取体验。

主要优势

• 直接访问PDF：无需手动转换即可读取和分析PDF文档
• 高级AI分析：利用Gemini的视觉和语言模型进行深入文档理解
• 文本提取：从PDF中提取结构化和非结构化文本
• 内容搜索：在PDF文档中搜索特定信息
• 无缝集成：原生支持Claude Code、Claude Desktop和Cursor
• 简单安装：通过Homebrew、Go或预构建二进制文件快速设置

安装

使用Homebrew（macOS和Linux）

brew tap alcova-ai/tap
brew install pdf-reader-mcp

从源码安装

克隆仓库并手动构建：

git clone https://github.com/Alcova-AI/pdf-reader-mcp.git
cd pdf-reader-mcp
go build -o pdf-reader-mcp-server .

从二进制发布（其他平台）

从发布页面下载预构建的二进制文件。

使用

此服务器仅支持用于MCP通信的stdio协议。

在Claude Code中设置

添加到Claude Code：

claude mcp add-json --scope user pdf-reader-mcp '{"type":"stdio","command":"pdf-reader-mcp","env":{"GEMINI_API_KEY":"YOUR-GEMINI-API-KEY-HERE"}}'

就这样！你现在可以在Claude Code中读取和分析PDF了。

在Claude Desktop中设置

添加到Claude Desktop：

1. 编辑Claude Desktop MCP配置：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. 添加PDF阅读器MCP服务器：

  {
    "mcpServers": {
+        "pdf-reader-mcp": {
+            "command": "pdf-reader-mcp",
+            "args": [
+                "--model",
+                "gemini-1.5-flash"
+            ],
+            "env": {
+                "GEMINI_API_KEY": "YOUR-GEMINI-API-KEY-HERE"
+            }
+        }
    }
  }

命令行选项

• --model, -m：指定用于PDF分析的Gemini模型（默认："gemini-1.5-flash"）
  • 也可以通过GEMINI_MODEL环境变量设置
• --max-pages：一次处理的最大页数（默认：10）
• --temp-dir：临时文件存储目录（默认：系统临时目录）

示例：

pdf-reader-mcp --model gemini-1.5-pro --max-pages 20

直接执行

如果你想要直接运行服务器（不推荐大多数用户这样做）：

1. 将你的Gemini API密钥设置为环境变量：

   export GEMINI_API_KEY=your-api-key-here
   

2. 运行服务器：

   pdf-reader-mcp
   

许可证

MIT