CLDGeminiPDF MCP服务器
快速开始
- 下载：从获取预构建的JAR 发布
- API密钥：从获取您的免费Gemini API密钥 谷歌人工智能工作室
- 配置：使用JAR路径和API键将服务器添加到Claude Desktop配置中
- 分析：开始与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（推荐）
- 下载最新
CLDGeminiPDF.v1.0.0.jar从 发布 页 - 将其保存到系统上方便的位置
选项2：从源代码构建
git clone
cd CLDGeminiPDF
mvn clean compile assembly:single这将创建一个JAR文件，其中包含 target/ 目录。
获取Gemini API密钥
- 访问 谷歌人工智能工作室
- 使用您的Google帐户登录
- 单击“获取API密钥”并创建新密钥
- 复制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免费层用户数据*
| 型号 | 描述 | 限制 |
|---|---|---|
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 | 具有高级功能的专业版 | 可用性有限 |
gemini-2.0-flash | 稳定、快速的型号（默认） | 15 RPM，1M TPM |
gemini-2.0-flash-lite | 轻量级版本 | 30转/分，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-层级*
使用示例
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.故障排除
常见问题
- “未设置GEMINI_API_KEY环境变量！”
- 确保您的API密钥在Claude Desktop配置中正确设置 - 更新配置后重新启动Claude Desktop
- “找不到PDF文件或无法读取”
- 验证文件路径是否正确，是否在文件系统服务器允许的目录内 - 确保PDF文件存在并且可读 - 检查文件权限
- “Gemini API错误：401”
- 验证您的API密钥是否正确有效 - 检查您的API密钥是否在Google AI Studio中具有必要的权限
- “Gemini API错误：429”
- 你已达到利率上限。请稍候，然后重试 - 考虑使用具有更高速率限制的模型（见上表）
- 文件系统服务器不工作
- 确保文件系统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
cd CLDGeminiPDF
mvn clean compile assembly:singleJAR文件将在 target/ 目录。
依赖项
- Jackson（JSON处理）
- Apache PDFBox（PDF文本提取）
- MCP Java SDK（模型上下文协议）
- Java HTTP客户端（API通信）
贡献
欢迎投稿！请随时提交拉取请求。对于重大更改，请先打开一个问题来讨论您想要更改的内容。
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。
支持
对于问题和疑问：
- 检查上面的故障排除部分
- 审查 Claude Desktop MCP文档
- 检查 Google AI Studio API文档
- 在此存储库上打开一个问题