PDF阅读服务器

MCP PDF阅读器服务器

模型上下文协议（MCP）服务器，使Claude、Windsurf和其他MCP兼容工具等AI助手能够读取和分析PDF文件。

特性

• 📄 从以下位置读取PDF文件 本地路径或URL
• 🔍 在PDF中搜索特定术语
• 📊 获取PDF元数据（页数、作者、标题等）
• 📖 阅读特定页面或页面范围
• 🌐 从网络下载和分析PDF
• 🤖 通过MCP与AI助手无缝集成

安装

使用npm

npm install -g @dev.saqibaziz/mcp-pdf-reader

使用npx（无需安装）

npx @dev.saqibaziz/mcp-pdf-reader

配置

适用于克劳德桌面

将此添加到您的Claude Desktop配置文件中：

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

{
  "mcpServers": {
    "pdf-reader": {
      "command": "npx",
      "args": ["-y", "@dev.saqibaziz/mcp-pdf-reader"]
    }
  }
}

适用于风帆

选项1：通过插件商店（即将推出）

• 开放式风帆
• 点击 Plugins Cascade面板中的图标
• 搜索“PDF阅读器”
• 点击 Install

选项2：手动配置

编辑MCP配置文件：

macOS: ~/Library/Application Support/Windsurf/User/globalStorage/codeium.codeium/mcp_config.json 视窗: %APPDATA%\Windsurf\User\globalStorage\codeium.codeium\mcp_config.json Linux: ~/.config/Windsurf/User/globalStorage/codeium.codeium/mcp_config.json

{
  "mcpServers": {
    "pdf-reader": {
      "command": "npx",
      "args": ["-y", "@dev.saqibaziz/mcp-pdf-reader"]
    }
  }
}

添加后，单击插件面板中的刷新按钮。

对于克莱恩

将此添加到MCP设置文件中：

{
  "mcpServers": {
    "pdf-reader": {
      "command": "npx",
      "args": ["-y", "@dev.saqibaziz/mcp-pdf-reader"]
    }
  }
}

可用工具

服务器为AI助手提供以下工具：

read_pdf_pages

从PDF文件中读取特定页面。

参数：

• pdf_path （string）：PDF文件的路径
• pages （array）：要读取的页码列表

read_pdf_page_range

从PDF文件中读取一系列页面。

参数：

• pdf_path （string）：PDF文件的路径
• start_page （编号）：首页阅读（含）
• end_page （编号）：最后一页（含）

search_pdf

在PDF文件中搜索术语，并返回包含它们的页面。

参数：

• pdf_path （string）：PDF文件的路径
• terms （字符串或数组）：搜索词

get_pdf_metadata

从PDF文件中获取元数据（页数、作者、标题等）。

参数：

• pdf_path （string）：PDF文件的路径

使用示例

配置后，您可以询问您的AI助手：

本地文件：

• “阅读document.pdf中的第1-5页”
• “在research.pdf中搜索‘机器学习’”
• “report.pdf的元数据是什么？”
• “阅读演示文稿.pdf中的第10页”

网址：

• “阅读此PDF：https://example.com/research-paper.pdf"
• “搜索'气候变化'https://example.com/report.pdf"
• “从以下位置获取元数据https://arxiv.org/pdf/2301.00001.pdf"
• “阅读第1-3页https://example.com/whitepaper.pdf"

发展

先决条件

• Node.js>=18.0.0
• npm或纱线

设置

# Clone the repository
git clone https://github.com/Saqib-Aziz007/mcp-pdf-reader.git
cd mcp-pdf-reader

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

脚本

• npm run build -将TypeScript编译为JavaScript
• npm run dev -开发观看模式
• npm start -运行已编译的服务器
• npm run prepare -预安装构建挂钩

技术细节

此MCP服务器由以下组件构建：

• @模型上下文协议/sdk -用于TypeScript的MCP SDK
• pdf解析 -PDF解析库
• TypeScript用于类型安全

贡献

欢迎投稿！请随时提交拉取请求。

许可证

MIT许可证-请参阅 许可证 详细信息文件

作者

穆罕默德·萨奇布·阿齐兹

• 电子邮件：saqib.aziz1000@gmail.com
• github： @Saqib-Aziz007
• npm： @萨奇巴齐兹

支持

如果您遇到任何问题或有疑问：

• 打开一个问题 GitHub
• 检查 MCP文件

致谢

使用Anthropic的模型上下文协议构建。