Pdf MCP Server

🚀 PDF Tools MCP Server

這是一個用於操作PDF文件的Model Context Protocol (MCP) 服務器，可通過Claude Desktop、Claude Code等MCP客戶端使用。

✨ 主要特性

✨ 輕鬆創建排除特定頁面的PDF文件

其他PDF工具通常具備「提取特定頁面」的功能，而本工具則提供了相反的「排除特定頁面」功能。例如，若要從一個31頁的PDF中刪除第7頁，無需指定其餘30頁，僅需指定要排除的頁碼即可。

✨ 自由重新排列PDF頁面順序

通過頁面重排功能，可輕鬆更改PDF的頁面順序。能夠直觀地修正因掃描錯誤導致的頁面順序顛倒問題，或把特定頁面移到開頭位置。

📦 功能

• merge_pdfs - 將多個PDF文件合併為一個
• split_pdf - 將PDF拆分為單頁文件
• extract_pages - 從PDF中提取特定頁面
• extract_text - 從PDF中提取文本
• exclude_pages ⭐ - 創建排除特定頁面後的新PDF文件
• reorder_pages - 按照指定順序重新排列PDF頁面
• get_pdf_info - 獲取PDF的相關信息（如頁數、標題、創建者等）

📦 安裝指南

# 克隆倉庫
git clone https://github.com/h-ucchi/pdf-mcp-server.git
cd pdf-mcp-server

# 安裝依賴
npm install

# 構建
npm run build

💻 使用示例

使用Claude Desktop（桌面應用）

1. 打開Claude Desktop的配置文件

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

2. 添加以下配置

{
  "mcpServers": {
    "pdf-tools": {
      "command": "node",
      "args": ["/絕對路徑/pdf-mcp-server/build/index.js"]
    }
  }
}

⚠️ 重要提示

請將/絕對路徑/替換為實際的項目路徑。

3. 重啟Claude Desktop
4. 在Claude Desktop中使用自然語言請求PDF操作

從PDF中提取第5頁
合併多個PDF文件
創建排除PDF第7頁的文件

使用Claude Code（CLI）

1. 註冊MCP服務器

claude mcp add --transport stdio pdf-tools -- node /path/to/pdf-mcp-server/build/index.js

2. 在Claude Code中使用自然語言請求PDF操作

從PDF中提取第5頁
合併多個PDF文件
創建排除PDF第7頁的文件
創建排除PDF第3、7、15頁的文件

3. 檢查MCP服務器

# 查看已註冊的MCP服務器
claude mcp list

具體使用示例

基礎用法

從document.pdf中排除第7頁
→ 會創建一個從31頁中刪除第7頁後的30頁PDF文件

從presentation.pdf中排除第3、7、15頁
→ 可一次性排除多個頁面

高級用法

從document.pdf中提取第5頁

合併文件夾內的所有PDF文件

將report.pdf拆分為單頁文件

交換PDF的第3頁和第5頁
→ 可自由重新排列頁面順序

將第5頁移到開頭
→ 頁面會按 [5, 1, 2, 3, 4, 6, 7, ...] 的順序重新排列

🔧 技術細節

技術棧

• Model Context Protocol SDK - MCP實現
• pdf-lib - PDF操作
• pdf-parse - PDF文本提取
• TypeScript

開發

# 構建
npm run build

# 開發模式（文件監聽）
npm run build -- --watch

📚 詳細文檔

故障排除

Claude Desktop出現「Server disconnected」錯誤

原因：由於macOS的安全限制，Claude Desktop可能無法訪問桌面文件夾中的文件。 解決辦法：請將項目移至主目錄。

# 將項目移至主目錄
mv ~/Desktop/pdf-mcp-server ~/pdf-mcp-server

# 更新配置文件路徑
# ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "pdf-tools": {
      "command": "node",
      "args": ["/Users/你的用戶名/pdf-mcp-server/build/index.js"]
    }
  }
}

# 重啟Claude Desktop

查看日誌

可通過查看Claude Desktop的日誌獲取詳細的錯誤信息。

# macOS
tail -f ~/Library/Logs/Claude/mcp-server-pdf-tools.log

# Windows
type %USERPROFILE%\AppData\Local\Claude\Logs\mcp-server-pdf-tools.log

檢查MCP服務器是否啟動

# 在終端中直接運行進行測試
node /path/to/pdf-mcp-server/build/index.js
# 若顯示 "PDF Tools MCP Server started" 則表示正常

相關鏈接

• Model Context Protocol
• Claude Code