プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

McpStamp PDF Tools

作者:theluckystrikeバージョン 0.23.0i★ 2 (リポジトリ全体のスター)iパソコンでもクラウドでも公式サイト ↗
レジストリ名io.github.theluckystrike/pdf-merge-split-stamp-extract-pages

インストール方法

What it does

Merge, split, extract, rotate, reorder and stamp PDF pages, and pull the text out of a PDF.

  • Connects パソコンでもクラウドでも
  • Account or key No key needed
  • Category 文書・表計算・事務作業

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

作者:opendatalab★ 83,9191 個の skill

Skill · 手順書ライセンス記載なし

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

作者:guillaumemeyer★ 27,7231 個の skill

Skill · 手順書

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

作者:kepano★ 53,104 (whole repo)5 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア20/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

McpStamp PDF Tools をインストールして。https://mcp.popnx.com/i/theluckystrike-pdf-merge-split-stamp-extract-pages.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(mcp.zovo.one)を通ります · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前McpStamp PDF Tools
    Remote MCP server URL · アドレスhttps://mcp.zovo.one/mcp/pdf

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsMcpStamp PDF Tools

  4. 試してみる

    McpStamp PDF Tools を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が McpStamp PDF Tools を使っていると言うか、回答に McpStamp PDF Tools のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前McpStamp PDF Tools
    Connection · アドレスhttps://mcp.zovo.one/mcp/pdf
  3. チャットで McpStamp PDF Tools を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から McpStamp PDF Tools を選びます

  4. 試してみる

    McpStamp PDF Tools を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が McpStamp PDF Tools を使っていると言うか、回答に McpStamp PDF Tools のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user pdf-merge-split-stamp-extract-pages https://mcp.zovo.one/mcp/pdf
  3. Claude Code で /mcp と入力

    McpStamp PDF Tools が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    McpStamp PDF Tools を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が McpStamp PDF Tools を使っていると言うか、回答に McpStamp PDF Tools のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    McpStamp PDF Tools を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が McpStamp PDF Tools を使っていると言うか、回答に McpStamp PDF Tools のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    McpStamp PDF Tools を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が McpStamp PDF Tools を使っていると言うか、回答に McpStamp PDF Tools のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp.zovo.one/mcp/pdf

JSON 設定は下の「開発者向け」にあります

つまずいたら?McpStamp PDF Tools を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user pdf-merge-split-stamp-extract-pages https://mcp.zovo.one/mcp/pdf

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "pdf-merge-split-stamp-extract-pages": {
      "url": "https://mcp.zovo.one/mcp/pdf"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "pdf-merge-split-stamp-extract-pages": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/pdf"
    }
  }
}

自分で入力する値

  • MCP_LICENSE_KEY 秘密 env
    任意の Pro ライセンスキー(MCPL1....)。オフラインで検証されます
    英語の原文を見るOptional Pro license key (MCPL1....). Verified offline.

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

GitHubスターi
2 (リポジトリ全体のスター)
このリポジトリには複数の MCP があり、スターは順位で1件だけ数えます
週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンでもクラウドでも
最新バージョンi
0.23.0
レジストリ公開日i
2026年11月2日
コードの最終更新i
2026年11月18日
最終確認
2026年11月17日
作者
theluckystrike
パッケージ
mcpb: …/pdf.mcpb
ウェブサイト
www.mcpstamp.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月17日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • pdf_info

    Call this tool to inspect a PDF: page count, page sizes in points/mm, paper name, metadata (title, author, producer, dates) and whether it is encrypted. Read-only, never modifies the file. Free tier: unlimited.

  • pdf_count

    Page count per file plus the total, for any number of PDFs, with how many were readable. A file that cannot be read is reported on its own row and the others still count. Read-only. Free and unlimited.

  • pdf_merge

    Call this tool to join several PDFs into one, in the order given. Page sizes are kept as-is, so a merged file may have mixed sizes, and the answer says so. Inputs are never modified. Free tier: up to 5 files per merge.

  • pdf_split

    Call this tool to write one new PDF per range. Ranges are 1-based and may be open-ended: "1-3,5,7-" gives pages 1-3, page 5, and 7 to the end. The input is never modified. Free tier: files up to 30 pages.

  • pdf_pages

    Call this tool to pull selected pages into one new PDF, in the order written: "2,4-6" gives four pages. Asking for a page twice copies it twice. The input is never modified. Free tier: files up to 30 pages.

  • pdf_rotate

    Call this tool to turn pages by a multiple of 90 degrees, clockwise for positive. Rotation is added to whatever the page already had, for a sideways scan. Writes a new file. Free tier: files up to 30 pages.

  • pdf_stamp

    Call this tool to draw a word such as PAID or DRAFT across the pages, in a colour and position you choose. Writes a new file; input untouched. Free tier: the PAID and DRAFT presets in their preset colours.

  • pdf_watermark_business

    Call this tool to put your business name and VAT id in the footer of every page, from the shared profile mcp-invoice and mcp-docx write. Use it before sending a document out. Pro.

  • pdf_reorder

    Call this tool to write a new PDF with pages in the order you give. The order must name every page exactly once, so nothing drops by accident; use pdf_pages for a subset. Pro.

  • pdf_text

    Call this tool for best-effort text extraction from standard-font PDFs. Returns nothing for a scan (no OCR), or glyph indices for a custom-encoded font, and says which case applies. Read-only. Free tier: unlimited.

  • license_status

    Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.

  • license_activate

    Turn Pro on for this connection with key, an MCPL1. . issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.

  • pdf_upload

    Send a PDF to this hosted endpoint. There is no filesystem here, so instead of a path you upload the file once with pdf_upload and then pass its name as `path` (or inside `paths`) to pdf_info, pdf_count, pdf_merge, pdf_split, pdf_pages, pdf_rotate, pdf_stamp, pdf_reorder and pdf_

  • pdf_files

    List the PDFs stored for your token: what you uploaded, and what this server has written, with their sizes.

  • pdf_delete_upload

    Delete one PDF stored for your token, uploaded or generated.

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント theluckystrike で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    1321ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    15件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

公開済みの脆弱性(OSV.dev)

未確認:バージョン付きの npm と PyPI パッケージのみ確認できます

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/theluckystrike-pdf-merge-split-stamp-extract-pages.svg)](https://mcp.popnx.com/en/servers/theluckystrike-pdf-merge-split-stamp-extract-pages)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

文書・表計算・事務作業のほかのサーバーとの比較i

  • このカテゴリのほかの4110件のうち0%よりスターが多い
  • このカテゴリのほかの4110件のうち65%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの4110件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

McpStamp PDF Toolsは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.23.0)がレジストリに届いたのは17 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

作者:HeyPuter広く使われている★ 4.4万5 か月前更新

クラウドで動く✓ 提供元 · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

作者:getsentry広く使われている↓ 13万/週 共有パッケージの数★ 65854 か月前更新

パソコンで動く✓ 提供元 · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

作者:Vexa-ai広く使われている★ 29942 か月前更新

クラウドで動く✓ 提供元 · vexa.ai

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

作者:ankimcp成長中↓ 1136/週★ 567先月更新

パソコンで動く✓ 提供元 · ankimcp.ai
似たものと比べる
これ
McpStamp PDF Tools
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要
キーが必要いいえいいえいいえはいいいえいいえ
Claude で + から追加いいえいいえいいえいいえはいいいえ
基本チェック5/54/43/32/44/43/3
ライセンスMITAGPL-3.0MITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Merge, split and fill PDF forms from Claude

Say "stamp PAID on that invoice and save a copy" or "pull pages 2 to 6 out of this scan and merge them with the contract" and it happens, on your machine, in a second. This MCP server does the small PDF jobs that otherwise send you to a web uploader: merge, split by page range, extract or reorder pages, rotate a sideways scan, stamp PAID or DRAFT or any text you like, put your business name and VAT id in the footer, count pages across a folder of files, and read a PDF's text back as text. No upload, no account, no native dependency, no office install.

In the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.theluckystrike%2Fpdf-merge-split-stamp-extract-pages/versions/latest) (io.github.theluckystrike/pdf-merge-split-stamp-extract-pages).

Listed on the [AI Product Index](https://index.percall.dev/l/zovo-pdf.html) - live remote endpoint at mcp.zovo.one/s/pdf, free tier, no signup.

The PDF chores of a freelance business, done from chat instead of from a browser tab you do not trust with an invoice.

60-second install

npm publish for @theluckystrike/mcp-pdf is pending. Until then, the .mcpb one-click bundle or a clone+build is the working path, both are verified below.

One-click (.mcpb): download pdf.mcpb from the latest release and double-click it in Claude Desktop: https://github.com/theluckystrike/mcp-servers/releases/latest

(claude_desktop_config.json):

{

"mcpServers": { "pdf": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-pdf"] } } }

Claude Code:

claude mcp add pdf -- npx -y @theluckystrike/mcp-pdf

(.cursor/mcp.json):

{

"mcpServers": { "pdf": { "command": "npx", "args": ["-y", "@theluckystrike/mcp-pdf"] } } }

The npx form above starts working the moment the package is published. Until then, use the .mcpb bundle above, or build from source with exactly these three commands:

git clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-servers

npm install npm run build -w packages/mcp-license -w servers/pdf

Then point your client's command at node with one arg: the absolute path to servers/pdf/dist/index.js.

To run in Pro mode set MCP_LICENSE_KEY in the same config block, or call license_activate once with your key.

Tools

ToolWhat it does
pdf_infoPage count, every page's size in points and millimetres, the paper name (A4, Letter, custom), the rotation already on each page, the metadata (title, author, producer, dates) and whether the file is encrypted
pdf_countPage count per file plus the total, for any number of PDFs. A file it cannot read is reported per file; the rest still count
pdf_mergeJoin PDFs into one, in the order given. Page sizes are kept as they are, and a merged file with mixed sizes says so
pdf_splitOne new file per range. "1-3,5,7-" gives pages 1-3, page 5, and page 7 to the end. out_path_pattern takes {n}, {range} and {name}
pdf_pagesExtract selected pages into one new PDF, in the order you write them. "5,1,1" puts page 5 first and page 1 in twice
pdf_rotateTurn pages by a multiple of 90 degrees, added to the rotation the page already had, which is what a sideways scan needs
pdf_stampDraw text on the pages: PAID and DRAFT presets, or any text, colour, position, opacity and size. Centre stamps go on the 45-degree diagonal
pdf_watermark_businessYour business name and VAT id in the footer of every page, from the shared profile mcp-invoice and mcp-docx write
pdf_textBest-effort text extraction from the page content streams. See the honest caveats below
pdf_reorderWrite a new PDF with the pages in a new order. The order must name every page exactly once, so nothing is dropped by accident
license_statusShow free or Pro mode
license_activateActivate a Pro key (verified offline)

Resource: pdf://recent returns the last 25 operations, newest first, with the inputs, the files written and when. Prompt: mark_invoice_paid chains mcp-invoice's invoice_get into pdf_stamp PAID and saves the stamped copy beside the original.

What you can say

You sayTool
"Mark invoice INV-2026-0007 as paid."mark_invoice_paid prompt, then pdf_stamp
"Stamp DRAFT across this contract before I send it."pdf_stamp
"Join these three PDFs into one file."pdf_merge
"Split the scan: pages 1-3 are the invoice, 4 onwards is the receipt."pdf_split
"Pull pages 2 to 6 out of this and save them separately."pdf_pages
"This scan is sideways, turn it."pdf_rotate
"How many pages are in all of these?"pdf_count
"What does page 1 of this PDF say?"pdf_text
"Put my company name and VAT number in the footer."pdf_watermark_business
"Move the cover page to the front."pdf_reorder

Worked example

You: Stamp PAID on ~/invoices/INV-2026-0007.pdf and save a copy.

pdf_stamp { path: "~/invoices/INV-2026-0007.pdf", text: "PAID", position: "center", out_path: "~/invoices/INV-2026-0007-paid.pdf" } -> Stamped "PAID" on 1 page -> ~/invoices/INV-2026-0007-paid.pdf, 0.9 MB

The stamp is drawn text, not a flattened image: it can be selected and searched, it is drawn on the 45-degree diagonal in the preset green, and the original file is byte-for-byte unchanged.

Free vs Pro

FreePro
pdf_info, pdf_count, pdf_textUnlimitedUnlimited
pdf_mergeUp to 5 files per callAny number of files
pdf_split, pdf_pages, pdf_rotateFiles up to 30 pagesAny length
pdf_stampThe PAID and DRAFT presets in their preset coloursAny text, any colour, any size
pdf_watermark_business-Your business name and VAT id in the footer
pdf_reorder-Yes

A tier limit is an answer, not an error, and nothing is written when one refuses a call.

Pro is a one-time $19, or $39 for every server in the collection, lifetime.

pdf_text is best effort, and here is exactly what that means

A PDF does not store text. It stores drawing operators, and the text you see is bytes handed to a font. This server decompresses each page's FlateDecode content stream with node:zlib and reads the four text-showing operators -- Tj, TJ, ' and ", plus the positioning operators that end a line. That is a parser written here, in about two hundred lines, with no pdfjs and no native module, and it has three real limits the tool states in its own answer every time:

  • A scan has no text. An image-only page carries no text operators, so nothing comes back. There is no OCR here and there will not be one; the answer says the page is probably a scan rather than returning an empty string with no explanation.
  • A custom or CID encoding returns glyph indices, not letters. Subset-embedded and CJK fonts map bytes to glyph numbers through a table this parser does not read. When the output has no readable characters, the answer says the font is the reason.
  • Reading order is drawing order. There is no column detection and no layout reconstruction. Word spaces are recovered from the large negative kerns a TJ array uses for them, so a PDF that positions every word separately can come back with words run together.

PDFs written by word processors, invoicing tools and report generators, everything with a standard or fully embedded font, read back cleanly. Anything else tells you why it did not.

Encrypted PDFs are refused, not guessed

pdf-lib cannot decrypt, and loading an encrypted file while ignoring the encryption produces pages of garbage that would be written straight into the output. So a file whose trailer names an /Encrypt dictionary is refused by every tool that writes, with the reason and the fix in the message: open it in a reader with the password, export or print to a new PDF, and use that file. pdf_info still answers, with encrypted: true, because reporting is its whole job, and pdf_count reports it as one unreadable file while still counting the rest.

Existing files are never overwritten, and inputs are never modified

Every tool writes a new file and leaves its inputs byte-for-byte alone, there is no in-place mode, on purpose. An out_path that already exists is refused:

Error: /path/merged.pdf already exists and nothing was written.

Pass overwrite: true to replace it, or give a different out_path.

The path is reserved with an exclusive create, not an existence check, so two processes writing the same out_path at the same time cannot clobber each other: one wins, the other is refused and writes nothing. pdf_split reserves every one of its output paths before it writes any of them, so a collision on part 3 does not leave parts 1 and 2 behind as a half-done split, and the reservations are released, so nothing empty is left on disk either.

Pass overwrite: true when replacing the file is what you want.

overwrite: true still does not let an output be an input. Writing the result of an operation back over one of its own sources destroys that source, the pages are already in memory and get written over the file they came from, which takes a three-page file to the one page you extracted, and every later read of that path is then quietly wrong. So an out_path that resolves to (or shares an inode with) any input of the same call is refused before any work happens:

Error: out_path /path/scan.pdf is also an input of this operation, so writing it would destroy the source.

Nothing was written. Write beside it instead - /path/scan-out.pdf - and, if the result really is meant to take the original's place, rename it yourself once you have checked it.

Limits

  • Inputs over 100 MB are refused: rewriting a PDF needs several times its size in memory.
  • A file that does not start with %PDF- is refused before anything is read.
  • Rotation is recorded as page metadata, in multiples of 90 degrees, which is all the format has. Nothing is redrawn.
  • Stamp text goes through a built-in PDF font, which carries WinAnsi and its 256 code points. A character outside it is transliterated where it has an obvious Latin body, Polish OPŁACONE stamps as OPLACONE, and the answer says so and prints what was actually drawn, and removed and counted where it does not, so there is no CJK stamp. A newline is a word separator, never a deletion.
  • font_size must be between 1 and 1600 points. A stamp too long to fit even at the smallest size this server will use is still drawn, and the answer says how far past the edge it runs, so you can shorten it.
  • pdf_text caps one answer at 200,000 characters and names the pages argument that continues from where it stopped. Nothing is missing from the file; the cut is in the answer, not the read.
  • No page numbering, no signatures, no redaction, no compression. This server does the page-level jobs; it is not a PDF editor. It does not *write* PDF/A: pdf_info reports a file's own pdfa_claim, and every tool that writes says plainly that its output no longer holds that claim.
  • Forms are read, not filled: pdf_text prints the AcroForm field values, which live in the fields rather than in the page content stream and are therefore not part of the page text.
  • No OCR. See the pdf_text section.

How it stores data

Only a register of what it did: ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/pdf/operations.json, the last 500 operations, as plain JSON. Your PDFs stay where you put them. Every write to the register runs inside an advisory lock on .../pdf/.lock, so two clients on one data directory cannot lose a reco

冒頭だけを表示しています。続きはリポジトリで読めます