Pdf MCP Server

PDF工具MCP服务器

PDF用于处理文件Model Context Protocol (MCP) 服务器。Claude Desktop、Claude Code等的MCP可以从客户端使用。

特徴

✨ 仅排除特定页面PDF很容易创建文件

其他PDF工具通常提供“提取特定页面”功能，但该工具反而提供了“仅排除特定页面”功能。例如，有31页PDF如果只想删除第7页，则不需要指定所有剩余的30页，只可以指定想要排除的页码。

✨ PDF的页面可以自由排列

根据页面的排列功能PDF中所述修改相应参数的值。可以直观地进行修正因扫描错误而顺序颠倒的页面，或者将特定页面带到开头的作业。

机能

• 合并dfs -多个PDF将文件合并为一个
• split_pdf - PDF将拆分为每页文件
• 提取页面 - PDF从中提取特定页面
• 提取文本 - PDF从中提取文本
• exclude_pages ⭐ - PDF中选择新的扶手类型，来修改默认的扶手PDF创建
• 重新订购页面 - 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
• 窗户： %APPDATA%/Claude/claude_desktop_config.json

1. 添加以下设置

{
  "mcpServers": {
    "pdf-tools": {
      "command": "node",
      "args": ["/絶対パス/pdf-mcp-server/build/index.js"]
    }
  }
}

重要: /絶対パス/中描述的场景，使用下列步骤创建明细表，以便在概念设计中分析体量的周长。

1. Claude Desktop重新启动

1. 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

1. Claude Code用自然语言PDF请求操作

PDFから5ページ目を抽出して
複数のPDFを結合して
PDFの7ページ目を除外したファイルを作成して
PDFの3, 7, 15ページを除いたファイルを作成して

1. MCP服务器确认

# 登録されているMCPサーバーを確認
claude mcp list

使用例

排除页面（特性）

document.pdfから7ページ目を除いたファイルを作成して
→ 31ページから7ページ目だけを削除した30ページのPDFが作成されます

presentation.pdfから3, 7, 15ページを除外して
→ 複数ページを一度に除外できます

提取页面

document.pdfから5ページ目を抽出して

PDF结合

フォルダ内の全PDFを結合して

PDF分割

report.pdfを1ページずつ分割して

页面排序

PDFの3ページ目と5ページ目を入れ替えて
→ ページの順序を自由に並び替えられます

5ページ目を先頭に持ってきて
→ [5, 1, 2, 3, 4, 6, 7, ...] の順に並び替えられます

技术栈

• 模型上下文协议SDK - MCP実装
• pdf库 - PDF操作
• pdf解析 - PDF文本提取
• TypeScript

开発

# ビルド
npm run build

# 開発モード（ファイル監視）
npm run build -- --watch

故障排除

Claude Desktop中出现“Server disconnected”错误

原因: macOS的安全限制Claude Desktop的Desktop文件夹中的文件可能无法访问。

解决策将项目放置在主目录中。

# プロジェクトをホームディレクトリに移動
mv ~/Desktop/pdf-mcp-server ~/pdf-mcp-server

# 設定ファイルのパスを更新
# ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "pdf-tools": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/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" と表示されれば正常

相关链接

• 模型上下文协议
• 克劳德代码