An MCP server that enables Claude Desktop to analyze PDF documents using Google Gemini AI models, supporting both direct PDF upload and text extraction methods.

Installation

Download Pre-built JAR File

Download the latest CLDGeminiPDF.v1.0.0.jar from the Releases page

Build from Source

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

Configuration

Claude Desktop

{
  "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"
      }
    }
  }
}

Features

• PDF Analysis: Extract and analyze PDF content using Gemini AI models
• Multi-model Support: Choose from various Gemini models (2.5, 2.0, 1.5 series, and Gemma models)
• Dual Processing Methods: Direct PDF upload to Gemini or fallback text extraction
• MCP Integration: Seamless integration with Claude Desktop via Model Context Protocol
• Flexible Configuration: Environment variable configuration for easy deployment

Environment Variables

Required

• GEMINI_API_KEY - Google AI Studio API key for accessing Gemini models

Optional

• GEMINI_MODEL - Specific Gemini model to use (e.g., gemini-2.0-flash)

Usage Examples

Please analyze this research paper: file:///Users/username/Documents/research_paper.pdf Focus on the methodology and conclusions.

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.

List the available Gemini models

Notes

Requires Java 11 or higher and Filesystem MCP server as a dependency. Version 1.0.0 does NOT support drag-and-drop files — files must be accessible through the filesystem server. Free tier users have different rate limits for different Gemini models.