PDF分析服务器

CLDGeminiPDF MCP服务器

A. 模型上下文协议（MCP） 启用的服务器 克劳德桌面 使用谷歌的人工智能模型分析PDF文档。该服务器通过利用Gemini强大的语言理解能力来发送PDF文件并从PDF中提取文本，从而提供智能分析和见解。

快速开始

1. 下载：从获取预构建的JAR 发布
2. API密钥：从获取您的免费Gemini API密钥 谷歌人工智能工作室
3. 配置：使用JAR路径和API键将服务器添加到Claude Desktop配置中
4. 分析：开始与Claude一起分析PDF！

特性

• PDF分析：使用Gemini AI模型提取和分析PDF内容
• 多模型支持：从各种Gemini型号（2.5、2.0、1.5系列和Gemma型号）中选择
• 双重处理方法：直接将PDF上传到Gemini或回退文本提取
• MCP集成：通过模型上下文协议与Claude Desktop无缝集成
• 灵活的配置：基于环境的配置，便于部署

先决条件

• Java 11或更高版本
• 梅文 （从源头建设）
• Google AI Studio API密钥 （免费） aistudio.google.com)
• 克劳德桌面 应用
• 文件系统MCP服务器 （所需依赖性）

安装

选项1：下载预构建JAR（推荐）

1. 下载最新 CLDGeminiPDF.v1.0.0.jar 从 发布 页
2. 将其保存到系统上方便的位置

选项2：从源代码构建

git clone <your-repository-url>
cd CLDGeminiPDF
mvn clean compile assembly:single

这将创建一个JAR文件，其中包含 target/ 目录。

获取Gemini API密钥

1. 访问 谷歌人工智能工作室
2. 使用您的Google帐户登录
3. 单击“获取API密钥”并创建新密钥
4. 复制API密钥以便在环境变量中使用

Claude桌面集成

1.找到Claude桌面配置

配置文件的位置取决于您的操作系统：

• 视窗: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2.更新配置文件

将文件系统服务器和CLDGeminiPDF服务器添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/your/documents"
      ]
    },
    "CLDGeminiPDF": {
      "command": "java",
      "args": [
        "-jar",
        "/path/to/CLDGeminiPDF.v1.0.0.jar"
      ],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here",
        "GEMINI_MODEL": "gemini-2.0-flash"
      }
    }
  }
}

重要:

• 替换 /path/to/your/documents 包含PDF文件的目录
• 替换 /path/to/CLDGeminiPDF.v1.0.0.jar 带有下载的JAR文件的实际路径
• 替换 your_api_key_here 使用您的实际Gemini API密钥

路径示例：

• 视窗: "C:\\Users\\YourName\\Downloads\\CLDGeminiPDF.v1.0.0.jar"
• macOS: "/Users/YourName/Downloads/CLDGeminiPDF.v1.0.0.jar"
• Linux: "/home/yourusername/Downloads/CLDGeminiPDF.v1.0.0.jar"

3.重新启动克劳德桌面

关闭并重新启动Claude Desktop以使更改生效。

可用的Gemini型号

Google API免费层用户数据

模型可用性取决于您的API密钥和使用层。查看您的Google AI Studio帐户以了解可用型号。

数据来源于https://ai.google.dev/gemini-api/docs/rate-limits#free-层级

使用示例

CLDGeminiPDF MCP服务器需要 文件系统MCP服务器 访问PDF文件。它使用完整的文件路径或在允许的目录范围内查找文件。

备注：1.0.0版本不支持在聊天界面中拖放文件。文件必须可以通过文件系统服务器访问。

配置后，您可以在Claude Desktop中使用这些命令：

使用完整路径分析PDF

Please analyze this research paper: file:///Users/username/Documents/research_paper.pdf

Focus on the methodology and conclusions.

按名称查找和分析PDF

Find the "research_paper.pdf" file in the Documents directory and analyze it using Gemini.

列出可用型号

What Gemini models are available for PDF analysis?

使用特定模型

Analyze this contract using the gemini-2.5-pro model: file:///path/to/contract.pdf

Look for key terms and potential risks.

故障排除

常见问题

1. “未设置GEMINI_API_KEY环境变量！”

   • 确保您的API密钥在Claude Desktop配置中正确设置
   • 更新配置后重新启动Claude Desktop

2. “找不到PDF文件或无法读取”

   • 验证文件路径是否正确，是否在文件系统服务器允许的目录内
   • 确保PDF文件存在并且可读
   • 检查文件权限

3. “Gemini API错误：401”

   • 验证您的API密钥是否正确有效
   • 检查您的API密钥是否在Google AI Studio中具有必要的权限

4. “Gemini API错误：429”

   • 你已达到利率上限。请稍候，然后重试
   • 考虑使用具有更高速率限制的模型（见上表）

5. 文件系统服务器不工作

   • 确保文件系统MCP服务器配置正确
   • 检查文件系统配置中的目录路径是否正确
   • 验证Claude Desktop是否有权访问指定目录

调试

要启用详细的日志记录，您可以在配置中修改Java命令：

"args": [
  "-Djava.util.logging.level=INFO",
  "-jar",
  "/path/to/CLDGeminiPDF.v1.0.0.jar"
]

验证配置

通过询问Claude Desktop来测试您的设置：

List the available Gemini models

如果成功，您应该看到一个包含可用模型及其功能的JSON响应。

发展

从源头构建

git clone <your-repository-url>
cd CLDGeminiPDF
mvn clean compile assembly:single

JAR文件将在 target/ 目录。

依赖项

• Jackson（JSON处理）
• Apache PDFBox（PDF文本提取）
• MCP Java SDK（模型上下文协议）
• Java HTTP客户端（API通信）

贡献

欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

支持

对于问题和疑问：

• 检查上面的故障排除部分
• 审查 Claude Desktop MCP文档
• 检查 Google AI Studio API文档
• 在此存储库上打开一个问题