MCP_PDF_Server

3.4

If you are the rightful owner of MCP_PDF_Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP PDF Server는 PDF 파일을 효율적으로 관리할 수 있는 Model Context Protocol(MCP) 기반 서버입니다.

MCP PDF Server

MCP PDF Server는 PDF 파일을 효율적으로 관리할 수 있는 Model Context Protocol(MCP) 기반 서버입니다.

이 프로젝트는 임베디드 개발자인 제가, Cursor와 같은 AI 코딩 도구에서 PDF 데이터시트 문서를 직접 읽고 요약하거나, 질의응답 등으로 개발 업무를 더 편리하게 할 수 있도록 만들었습니다. 즉, AI가 PDF 데이터시트의 내용을 빠르게 파악하고, 필요한 정보를 바로 제공해줄 수 있도록 지원하는 것이 주된 목적입니다.

이 프로젝트는 두 개의 주요 컴포넌트로 구성되어 있습니다:

manager_server: FastAPI 기반의 웹페이지로, 사용자가 웹 UI를 통해 PDF 파일을 업로드하거나 다운로드하고, 파일 목록을 조회·관리할 수 있는 기능을 제공합니다. 또한 외부 시스템과의 연동을 위한 RESTful API도 함께 제공합니다.
mcp_server: manager_server에서 관리하는 PDF 파일을 기반으로, 파일명 검색 및 텍스트 추출 기능을 제공합니다. 추출된 텍스트는 MCP 프로토콜을 통해 외부 시스템(예: Cursor 등)과 연동할 수 있습니다.

주요 기능:

PDF 텍스트 추출 (로컬 파일 및 URL 지원)
파일명 기반 PDF 검색
PDF 목록 조회 및 관리
PDF 파일 웹 업로드/다운로드 지원
RESTful API 및 웹 서비스 제공
MCP 프로토콜을 통한 외부 시스템(Curator, Cursor 등) 연동

RESTful API와 웹 UI를 통해 외부 시스템과 쉽게 연동할 수 있으며, Docker와 로컬 환경 모두에서 손쉽게 배포 및 운영이 가능합니다. 데이터시트·논문·계약서 등 다양한 PDF 문서의 자동화된 관리와 검색에 적합합니다.

주요 특징

로컬 PDF 파일 및 URL로 접근 가능한 PDF에서 텍스트 추출
/app/datasheets 하위의 PDF 파일 목록 제공
파일명으로 PDF 검색 기능 제공
PyPDF2 기반의 안정적인 텍스트 추출 및 예외 처리
FastMCP 기반의 표준화된 MCP 툴 제공

도커(Docker)로 실행하기

이미지 빌드
```
docker build -t mcp-pdf-server:1.0.0 .
```
컨테이너 실행
```
docker run -d \
  -v /호스트/경로/데이터:/app/datasheets \
  -p 5050:5050 \
  -p 5080:5080 \
  --name mcp-pdf-server \
  mcp-pdf-server:1.0.0
```
- /호스트/경로/데이터에 PDF 파일을 넣으면 컨테이너 내부 /app/datasheets에서 접근할 수 있습니다.
- 5050, 5080 포트가 사용됩니다.

docker-compose 사용시

# docker-compose.yml의 /path/to/your/datasheets를 실제 PDF 폴더 경로로 수정하세요.
docker-compose up -d --build

로컬(Python)에서 직접 실행하기

의존성 설치
```
pip install -r requirements.txt
```

서버 실행

python mcp_server/mcp_pdf_server.py
# 또는
uvicorn manager_server.main:app --host 0.0.0.0 --port 5080

MCP 툴(API) 설명

read_local_pdf
로컬 PDF 파일 경로를 입력받아 텍스트를 추출합니다.
read_url_pdf
PDF 파일의 URL을 입력받아 텍스트를 추출합니다.
server_pdf_list
/app/datasheets 하위의 모든 PDF 파일 목록을 반환합니다.
server_pdf_search
파일명을 입력받아 서버에 있는 PDF 파일을 검색하고, 해당 PDF의 텍스트를 추출합니다.

경로 안내

PDF 데이터는 반드시 /app/datasheets 경로(도커 컨테이너 내부)에 위치해야 합니다.
도커 사용 시, 호스트의 PDF 폴더를 /app/datasheets로 마운트하세요.
소스코드는 /app/mcp_server에 위치합니다(컨테이너 내부 기준).

라이선스

Apache License 2.0
저자: Dev91

Related MCP Servers

View all file_systems servers →

excel-mcp-server

4.5

by haris-musa

A Model Context Protocol (MCP) server that lets you manipulate Excel files without needing Microsoft Excel installed.

MCP_PDF_Server

MCP PDF Server

주요 특징

도커(Docker)로 실행하기

로컬(Python)에서 직접 실행하기

MCP 툴(API) 설명

경로 안내

라이선스

Related MCP Servers

excel-mcp-server

Office-PowerPoint-MCP-Server

edgeone-pages-mcp

mcp-obsidian

mcp-obsidian

claude-code-mcp

mcp-filesystem-server

moling

obsidian-mcp-tools

gistpad-mcp

notion_mcp

python-mcp-server-client

UnityMCPIntegration

mcp-openapi-proxy

cursor-mcp-file-organizer

mcp-tool-kit

mcp-excel-server

obsidian-mcp-rest

pdf-reader-mcp

OpenSCAD-MCP-Server

needle-mcp

notion-mcp-light

paperless-mcp

ebook-mcp

wordpress-mcp-server

mcp-filesystem

kokoro-tts-mcp