modelcontextprotocol/ext-apps
Watch
1
0
Fork
You've already forked ext-apps
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ext-apps/examples/pdf-server/plugin/skills/pdf-reading/SKILL.md
Bryan Thompson 3de035dc8d
 Add MCPB packaging and Claude Code plugin for pdf-server (#491) 
* Add MCPB packaging and Claude Code plugin for pdf-server

Two distribution paths for the pdf-server:

1. **MCPB bundle** (Claude Desktop MCP Directory):
   - manifest.json: v0.3 manifest with tools, compatibility, privacy
   - .mcpbignore: excludes source/tests from bundle
   - icon.png: 64x64 PDF document icon

2. **Claude Code plugin** (plugin/):
   - .mcp.json: declares local stdio server via npx
   - commands: /pdf-research:read, /pdf-research:summarize
   - skills: pdf-reading skill for document navigation
   - Tested end-to-end: MCP server connects, all tools available

The plugin uses a local stdio MCP server pattern — the first known
instance in a knowledge-work plugin (all existing plugins use remote
HTTP connectors).

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Run prettier:fix to satisfy CI formatting checks

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-02-24 00:51:43 +00:00

1.2 KiB
Raw Blame History

name description
pdf-reading Read and navigate PDF documents using the local PDF server. Reference this when the user wants to open, read, search, or interact with any PDF file or academic paper.

PDF Reading

You have access to a local PDF server that provides interactive document viewing.

Available Tools

  • list_pdfs -- Show available PDFs. Call with no arguments.
  • display_pdf -- Open a PDF in the interactive viewer.
    • url (string): URL or local file path
    • page (number, optional): Starting page number

How to Use

When the user mentions a PDF, paper, or document:

  1. If they give a URL or path, call display_pdf directly
  2. If they say "open the paper" without specifying, call list_pdfs to show options
  3. After displaying, offer to summarize, extract data, answer questions

arXiv shortcuts:

  • arxiv.org/abs/2301.12345 is auto-converted to the PDF URL
  • Users can just say "open arxiv 2301.12345"

Supported remote sources: arXiv, bioRxiv, medRxiv, chemRxiv, Zenodo, OSF, HAL Science, SSRN

Best Practices

  • Always display the PDF before trying to analyze it
  • For multi-page documents, ask which section the user cares about
  • When comparing papers, display them one at a time and note key differences