CLDGeminiPDF MCP Server

CLDGeminiPDF MCP 服务

一个 Model Context Protocol（MCP） 服务，可让 Claude Desktop 使用 Google 的 AI 模型分析 PDF 文档。此服务会发送 PDF 文件并从 PDF 中提取文本，利用 Gemini 强大的语言理解能力提供智能分析和见解。

快速开始

1. 下载：从 Releases 获取预构建的 JAR
2. API 密钥：从 Google AI Studio 获取免费的 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 集成：通过 Model Context Protocol 与 Claude Desktop 无缝集成
• 灵活配置：基于环境变量的配置，便于部署

先决条件

• Java 11 或更高版本
• Maven（从源代码构建时需要）
• Google AI Studio API 密钥（在 aistudio.google.com 免费获取）
• Claude Desktop 应用程序
• Filesystem MCP Server（必需的依赖项）

安装

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

1. 从 Releases 页面下载最新的 CLDGeminiPDF.v1.0.0.jar
2. 将其保存到系统中方便访问的位置

选项 2：从源代码构建

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

此操作会在 target/ 目录中创建一个包含所有依赖项的 JAR 文件。

获取 Gemini API 密钥

1. 访问 Google AI Studio
2. 使用 Google 账号登录
3. 点击“Get API Key”并创建新密钥
4. 复制 API 密钥，以便在环境变量中使用

Claude Desktop 集成

1. 找到 Claude Desktop 配置文件

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

• Windows：%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 密钥

路径示例：

• Windows："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

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

可用的 Gemini 模型

Google API 免费层用户的数据

模型	描述	限制
gemini-2.5-flash-preview-05-20	最新预览版，性能出色	10 RPM，250K TPM
gemini-2.5-flash-preview-04-17	上一预览版本	10 RPM，250K TPM
gemini-2.5-pro-preview-05-06	Pro 版本，具备高级功能	可用性有限
gemini-2.0-flash	稳定、快速的模型（默认）	15 RPM，1M TPM
gemini-2.0-flash-lite	轻量级版本	30 RPM，1M TPM
gemini-1.5-flash	稳定的通用模型	15 RPM，250K TPM
gemini-1.5-pro	最大上下文窗口为 2M 个令牌	免费层用户不可用
gemma-3 models	开源模型，参数量最高达 27B	30 RPM，15K TPM

模型可用性取决于你的 API 密钥和使用层级。请查看你的 Google AI Studio 账户，了解可用模型。

数据来源：https://ai.google.dev/gemini-api/docs/rate-limits#free-tier

使用示例

CLDGeminiPDF MCP 服务需要 Filesystem MCP server 才能访问 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 环境变量！”

   • 确保已在 Claude Desktop 配置中正确设置 API 密钥
   • 更新配置后重启 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（Model Context Protocol）
• Java HTTP Client（API 通信）

贡献

欢迎贡献！请随时提交 Pull Request。对于重大更改，请先提出 issue，讨论你希望进行的更改。

许可证

本项目基于 MIT License 授权，详情请参阅 LICENSE 文件。

支持

如有问题或疑问：

• 查看上方的故障排除部分
• 查阅 Claude Desktop MCP 文档
• 查看 Google AI Studio API 文档
• 在此代码库中提交 issue