Skip to main content
Glama
lockon-n

PDF Tools MCP Server

by lockon-n
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
tempfile_dirNoThe directory for temporary files used for URL support. PDFs from URLs are downloaded here. Default is ~/.pdf_tools_temp~/.pdf_tools_temp
workspace_pathYesThe directory the tool can access. For security reasons, this tool can only access files within the specified workspace directory and cannot access files outside the workspace directory.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
read_pdf_pagesA

Read content from PDF file for specified page range.

Supports both local file paths and URLs. For URLs, the PDF will be downloaded
to a temporary directory and cached for future use.

Note: Avoid reading too many pages at once (recommended: <50 pages) to prevent errors.

Args:
    pdf_file_path: Path to the PDF file or URL to PDF
    start_page: Starting page number (default: 1)
    end_page: Ending page number (default: 1)
    
Returns:
    Extracted text content from the specified pages
get_pdf_infoA

Get basic information about a PDF file including page count.

Supports both local file paths and URLs. For URLs, the PDF will be downloaded
to a temporary directory and cached for future use.

Args:
    pdf_file_path: Path to the PDF file or URL to PDF
    
Returns:
    Basic information about the PDF file
merge_pdfsA

Merge multiple PDF files into one.

Supports both local file paths and URLs. URLs will be downloaded to temporary
files before merging. Mixed local and URL paths are supported.

Args:
    pdf_paths: List of paths to PDF files to merge (in order) - can include URLs
    output_path: Path where the merged PDF will be saved (must be local path)
    
Returns:
    Success message with merge details or error message
extract_pdf_pagesA

Extract specific pages from a PDF and create a new PDF.

Supports URLs for source PDF. The source PDF will be downloaded to a temporary
directory if it's a URL. Output path must be a local file path.

Args:
    source_path: Path to the source PDF file or URL to PDF
    page_numbers: List of page numbers to extract (1-indexed)
    output_path: Path where the new PDF will be saved (must be local path)
    
Returns:
    Success message with extraction details or error message
search_pdf_contentA

Search for regex pattern in PDF content and return paginated results.

Supports both local file paths and URLs. For URLs, the PDF will be downloaded
to a temporary directory and cached for future use.

Args:
    pdf_file_path: Path to the PDF file or URL to PDF
    pattern: Regular expression pattern to search for
    page_size: Number of results per page (10-50, default: 10)

Returns:
    Search results with UUID for pagination, or error message
search_pdf_next_pageB

Get next page of search results.

Args:
    search_id: Search session ID from previous search

Returns:
    Next page of search results or error message
search_pdf_prev_pageB

Get previous page of search results.

Args:
    search_id: Search session ID from previous search

Returns:
    Previous page of search results or error message
search_pdf_go_pageA

Go to specific page of search results.

Args:
    search_id: Search session ID from previous search
    page_number: Page number to go to (1-indexed)

Returns:
    Specified page of search results or error message
search_pdf_infoC

Get information about a search session.

Args:
    search_id: Search session ID from previous search

Returns:
    Information about the search session

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.7/5.0

Scored across 9 tools

Disambiguation4/5

Most tools have distinct purposes, but the search-related tools (search_pdf_content, search_pdf_go_page, search_pdf_info, search_pdf_next_page, search_pdf_prev_page) could be confusing as they form a tightly coupled set for pagination. The core PDF operations (extract, merge, read, get info) are clearly differentiated.

Naming Consistency5/5

All tools follow a consistent snake_case verb_noun pattern (e.g., extract_pdf_pages, merge_pdfs, search_pdf_content). The naming is predictable and readable throughout the set, with clear action-object relationships.

Tool Count4/5

9 tools is reasonable for a PDF-focused server, but the 5 search-related tools might feel slightly heavy compared to the 4 core PDF manipulation tools. The count is well-scoped overall, though some search tools could potentially be consolidated.

Completeness4/5

The server covers essential PDF operations (extract, merge, read, get info) and adds advanced search with pagination. Minor gaps include no PDF creation from scratch or editing capabilities, but the core workflows for analysis and manipulation are well-covered.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources