Skip to main content

Nano PDF MCP

A memory-efficient Model Context Protocol (MCP) server for reading and splitting large PDF files.
Built with fastmcp and pymupdf (PyMuPDF).

Tools

Tool 설명
get_pdf_info 파일 메타데이터 및 총 페이지 수 조회 — read_pdf 호출 전에 먼저 사용하세요
read_pdf 지정 페이지 범위 텍스트 스트리밍 추출
split_pdf 지정 페이지만 모아 새 PDF 생성
save_markdown_summary AI 정리 내용을 .md 파일로 저장

권장 사용 순서

1. get_pdf_info(filepath) → 총 페이지 수 확인
2. read_pdf(filepath, start_page, end_page) → 텍스트 읽기
3. save_markdown_summary(output_filepath, markdown_content) → 요약 저장

Installation

클론하거나 로컬에 설치하지 않아도 됩니다!
uv가 설치되어 있다면 아래 한 줄로 바로 실행됩니다.

Claude Desktop

claude_desktop_config.json에 아래 내용을 추가하세요:

{
  "mcpServers": {
    "nano-pdf-mcp": {
      "command": "uvx",
      "args": ["nano-pdf-mcp"]
    }
  }
}

Antigravity

.gemini/settings.json에 아래 내용을 추가하세요:

{
  "mcpServers": {
    "nano-pdf-mcp": {
      "command": "uvx",
      "args": ["nano-pdf-mcp"]
    }
  }
}

Architecture

  • 메모리 효율: 페이지 단위 스트리밍으로 대용량 PDF 처리 (전체 로드 없음)
  • 빠른 분할: insert_pdf로 C 레벨 포인터만 복사 — 재인코딩 없음
  • 안전한 로깅: 모든 로그는 stderr로 출력 (stdio 통신 오염 방지)
  • 명확한 오류: 잘못된 범위/경로 입력 시 즉각 오류 메시지 반환

Metadata

Release files for nano-pdf-mcp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nano-pdf-mcp 0.2.0
File Size Uploaded Provenance
nano_pdf_mcp-0.2.0.tar.gz 3.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for nano-pdf-mcp 0.2.0
File Interpreter ABI Platform
nano_pdf_mcp-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 8.4 kB

Release files / nano_pdf_mcp-0.2.0.tar.gz

Download URL nano_pdf_mcp-0.2.0.tar.gz
Size 3.9 kB
Tags Source
SHA-256 checksum
How to use checksums
62ae9f939462b8f193607654fcd497337f9a04ee9ec980e6789dbfa623a2addf
BLAKE2b-256 checksum
How to use checksums
6dc7fb6a48b7e656c7c1eb9acb957a32d4dcb509d8122a0c0f5366ba4d61cd55
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Release files / nano_pdf_mcp-0.2.0-py3-none-any.whl

Download URL nano_pdf_mcp-0.2.0-py3-none-any.whl
Size 4.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f7d2256818cd944f8d2928e5db6ccd05b015e1e9266e03c7005e1b511cd37647
BLAKE2b-256 checksum
How to use checksums
9c54db2f07fb1698ad915daeac5084a089735e311e085494819d3289df9dbb47
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.0

Security for nano-pdf-mcp 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page