STARWARCLOUD STARWAR.AI
返回市场
pdf-mcp服务器

pdf-mcp服务器

作者：tacyan2 星标更新：2025-10-27
安装使用来源：spider==github.com

项目介绍

📚 PDF MCP Server

使用Claude Code轻松下载和管理技术书PDF的工具

只需说“找一本关于Python的书”，即可搜索并下载无DRM的技术书籍。支持与NotebookLM集成！

<div align="center">

Rust License: MIT MCP

</div>

🎯 该工具的功能

功能描述使用方法
🔍 PDF搜索（新功能！）根据关键词搜索免费技术书籍“找一本关于Python的书”
📥 PDF下载自动从URL下载技术书籍PDF“下载Pro Git的PDF”
📋 列表显示将管理中的PDF以美观的表格形式展示“显示PDF列表”
📝 文本提取从PDF中提取正文文本“从这个PDF中提取文本”
☁️ Google Drive集成自动上传至NotebookLM“将这个PDF上传到Drive”

✨ 使用示例

搜索并下载PDF

你: “找一本关于Python的书”

Claude: 🔍 “Python”的搜索结果：找到2个PDF

1. 📚 Think Python
   📎 URL: https://greenteapress.com/thinkpython2/thinkpython2.pdf
   📝 描述: Allen B. Downey著。适合Python初学者的入门书籍
   🏷️ 来源: Green Tea Press

2. 📚 Python Data Science Handbook
   📎 URL: https://github.com/jakevdp/...
   📝 描述: Jake VanderPlas著。全面介绍NumPy、Pandas、Matplotlib
   🏷️ 来源: GitHub

💡 下载方法:
   可以说“下载第一个PDF”或“下载Think Python”。

你: “下载第一个PDF”

Claude: ✅ 已下载Think Python.pdf
📁 存储位置: ~/.pdf-mcp-server/pdfs/Think_Python.pdf
📊 文件大小: 2.9 MB

支持搜索的技术领域

  • 编程语言: Python, JavaScript, Rust, Go, Java
  • 版本控制: Git
  • 容器: Docker, Kubernetes
  • 操作系统: Linux
  • 数据科学: 机器学习、统计学、数据分析

🚀 安装步骤（三步走）

步骤1: 安装

git clone https://github.com/tacyan/pdf-mcp-server.git
cd pdf-mcp-server
cargo build --release

没有安装Rust的情况:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

步骤2: 注册到Claude Desktop

macOS:

open ~/Library/Application\ Support/Claude/

Windows:

%APPDATA%\Claude\claude_desktop_config.json

配置内容:

{
  "mcpServers": {
    "pdf-manager": {
      "command": "/YOUR_PATH/pdf-mcp-server/target/release/pdf-mcp-server",
      "args": [],
      "env": {}
    }
  }
}

⚠️ 请将/YOUR_PATH/替换为实际路径

步骤3: 重启Claude Desktop

为了使设置生效，请重启Claude Desktop。

🧩 在Cursor / Codex 中使用

pdf-mcp-server 添加了一个config子命令，可以自动生成针对各个客户端的配置片段。按照以下顺序操作，即使是新手也能顺利引入。

步骤1: 确认执行文件路径

  • 在仓库根目录运行pwd（macOS/Linux）或Get-Location（Windows PowerShell），记录项目的绝对路径。
  • 运行ls target/release/pdf-mcp-server / Test-Path .\target\release\pdf-mcp-server.exe检查二进制文件是否存在，如果不存在则重新运行cargo build --release。
  • 运行target/release/pdf-mcp-server --help 或 ./target/release/pdf-mcp-server.exe --help进行功能确认。

步骤2: 生成模板

  • macOS / Linux: target/release/pdf-mcp-server config <client>
  • Windows PowerShell: ./target/release/pdf-mcp-server.exe config <client>
  • <client> 可以是 cursor / codex / claude-desktop。输出将包含带有绝对路径的模板以及具体的操作步骤（日语）。
  • 如需将模板写入文件，可使用 --output <文件路径> 和 --force，或者使用 --apply-default 直接写入默认路径。

步骤3: 反映到各个客户端

  • Claude Desktop: 编辑 claude_desktop_config.json，在 mcpServers 中添加 "pdf-manager" 块 → 重启应用。
  • Cursor: 运行 target/release/pdf-mcp-server config cursor --apply-default（首次）或通过命令面板打开 mcp.json，在 mcpServers 中添加 "pdf-manager" 块 → 执行 Reload MCP Servers 或重启。
  • Codex (CLI/IDE): 运行 codex config edit 或打开 ~/.codex/config.toml，追加 [mcp_servers.pdf_manager] 块 → 通过 codex mcp list 确认识别。

这样就可以在Claude Desktop之外的环境中安全共享相同的MCP服务器定义。模板始终基于最新的执行路径生成，因此即使更换了机器，只需再次运行 config 命令即可重新设置。

💡 常见问题

Q: 可以下载哪些PDF？

A: 只能下载无DRM（无版权保护）的PDF：

✅ 可下载

  • 开源技术书籍（如Pro Git、The Rust Book等）
  • Creative Commons许可书籍
  • 作者公开免费提供的书籍
  • 购买的无DRM PDF

❌ 不可下载

  • Kindle等DRM保护文件
  • 非法复制的文件

Q: 如何与NotebookLM集成？

A: 按照以下步骤集成：

  1. 下载PDF
  2. 说“将此PDF上传到Google Drive”
  3. 打开NotebookLM
  4. 选择“添加源”→从“Google Drive”中选择PDF

Q: PDF保存在哪里？

A: 默认保存在~/.pdf-mcp-server/pdfs/（macOS/Linux）

Windows系统下: %USERPROFILE%\.pdf-mcp-server\pdfs\

🔧 Google Drive集成（可选）

若要使用上传至Google Drive的功能，需要额外设置。

详情请参阅 CONFIG_GUIDE.md。

📖 详细文档

文档内容
EXAMPLES.md💡 实战用法及案例
CONFIG_GUIDE.md🔧 Google Drive设置指南
CONTRIBUTING.md🤝 贡献项目的方法

🌟 热门免费技术书籍

该工具支持搜索和下载的热门技术书籍如下：

编程语言

  • Pro Git - Git完全指南
  • Think Python - Python入门书籍
  • Eloquent JavaScript - JavaScript完全指南
  • The Rust Programming Language - Rust官方书籍

数据科学

  • Python Data Science Handbook - NumPy、Pandas完全指南
  • Introduction to Statistical Learning - 统计学习基础

基础设施

  • The Linux Command Line - Linux命令完全指南
  • Docker Deep Dive - Docker实践指南

📝 许可证

MIT License

🤝 贡献

欢迎提交Pull Request、Issue和功能请求！

详情请参阅 CONTRIBUTING.md。

💡 只需说“找一本关于Python的书”，即可开始搜索和下载技术书籍！