PDF Reader MCP Server

PDF 리더 MCP 서버

로컬 파일과 URL을 모두 지원하며 PDF 파일에서 텍스트를 읽고 추출하기 위한 도구를 제공하는 MCP(Model Context Protocol) 서버입니다.

작가

필립 반 드 워커
이메일: philip.vandewalker@gmail.com
GitHub: https://github.com/trafflux

특징

• 로컬 PDF 파일에서 텍스트 콘텐츠 읽기
• PDF URL에서 텍스트 콘텐츠 읽기
• 손상되었거나 잘못된 PDF에 대한 오류 처리
• 로컬 PDF에 액세스하기 위한 볼륨 마운팅
• PDF 인코딩 자동 감지
• 표준화된 JSON 출력 형식

설치

1. 저장소를 복제합니다.

지엑스피1

2. Docker 이미지를 빌드합니다.

용법

서버 실행

로컬 PDF 파일에 액세스할 수 있는 서버를 실행하려면:

/path/to/pdfs PDF 파일 디렉토리의 실제 경로로 바꾸세요.

로컬 PDF 파일을 사용하지 않는 경우:

MCP 구성

MCP 설정 구성에 다음을 추가합니다.

로컬 파일 PDF 파일 없음:

사용 가능한 도구

1. read_local_pdf
   • 목적: 로컬 PDF 파일에서 텍스트 콘텐츠 읽기
   • 입력:
     { "path": "/pdfs/document.pdf" }
   • 산출:
     { "success": true, "data": { "text": "Extracted content..." } }
2. read_pdf_url
   • 목적: PDF URL에서 텍스트 콘텐츠 읽기
   • 입력:
     { "url": "https://example.com/document.pdf" }
   • 산출:
     { "success": true, "data": { "text": "Extracted content..." } }

오류 처리

서버는 다양한 오류 사례를 명확한 오류 메시지로 처리합니다.

• 유효하지 않거나 손상된 PDF 파일
• 누락된 파일
• 실패한 URL 요청
• 권한 문제
• 네트워크 연결 문제

오류 응답은 다음 형식을 따릅니다.

종속성

• 파이썬 3.11+
• PyPDF2: PDF 구문 분석 및 텍스트 추출
• 요청: URL에서 PDF를 가져오기 위한 HTTP 클라이언트
• MCP SDK: 모델 컨텍스트 프로토콜 구현

프로젝트 구조

특허

저작권 2025 필립 반 드 워커

Apache 라이선스 버전 2.0(이하 "라이선스")에 따라 라이선스가 부여되었습니다. 라이선스를 준수하지 않는 한 이 파일을 사용할 수 없습니다. 라이선스 사본은 다음 링크에서 확인하실 수 있습니다.

관련 법률에 의해 요구되거나 서면으로 동의하지 않는 한, 라이선스에 따라 배포되는 소프트웨어는 명시적이든 묵시적이든 어떠한 종류의 보증이나 조건 없이 "있는 그대로" 배포됩니다. 라이선스에 따른 권한 및 제한 사항을 규정하는 구체적인 내용은 라이선스를 참조하십시오.

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

연락하다

질문, 문제 또는 기여 사항이 있으시면 Philip Van de Walker에게 연락해 주세요.

• 이메일: philip.vandewalker@gmail.com
• GitHub: https://github.com/trafflux