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

권장 사용 순서

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 통신 오염 방지)
• 명확한 오류: 잘못된 범위/경로 입력 시 즉각 오류 메시지 반환