dsh-read-pdf — DSH가 PDF를 읽을 수 있게 하는 MCP 서버 + 명령줄 도구

Model Context Protocol 기반의 PDF 읽기 서버: 텍스트 추출, 중국어 OCR(스캔본), 페이지 렌더링, 파일 검색, 드래그 앤 드롭 받은편지함을 즉시 사용할 수 있습니다. 모든 MCP 클라이언트와 호환: DSH, Claude Desktop, Codex, Cursor 또는 직접 만든 애플리케이션. 저장소: https://github.com/xiaoxuPekingUniversity/dsh-read-pdf

영어 · 중국어

중국어

기능

명령줄 버전 pdf_tools.py는 MCP 클라이언트에 의존하지 않고 동일한 기능을 제공합니다.

PDF Drop 받은편지함(드래그 앤 드롭 업로드): pdf_drop_server.py는 의존성이 전혀 없는 로컬 웹 서비스로, 브라우저에서 PDF를 드롭 영역에 끌어다 놓으면 로컬 폴더에 저장됩니다 — AI에게 자료를 공급하기에 적합하며, 호스트가 첨부 파일 업로드를 지원할 필요가 없습니다.

설치

pip install -r requirements.txt

사용법

명령줄(CLI)

python pdf_tools.py info    exam.pdf
python pdf_tools.py text    exam.pdf --pages 1-3
python pdf_tools.py ocr     scanned.pdf            # 扫描版中文识别
python pdf_tools.py render  exam.pdf --pages 1-3
python pdf_tools.py find --dir ~/Downloads "期末"

PDF Drop 받은편지함(드래그 앤 드롭 업로드)

python pdf_drop_server.py --port 8765   # 浏览器打开 http://127.0.0.1:8765

MCP 서버로 사용

DSH(profiles/web/cordis.patch.yml에 추가):

- insert:
    - id: mcp-pdf
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        transport: stdio
        serverName: pdf
        command: python
        args:
          - /绝对路径/mcp_pdf_server.py
        failOnStartupError: false

DSH 네이티브 플러그인으로 사용(웹 설정 페이지 토글 포함, 권장)

ds-plugin/은 빌드가 필요 없는 호스트 플러그인을 제공하며, 설정 페이지에 'PDF 읽기' 토글(런타임 시 도구 시작/중지)이 제공됩니다. ds-plugin/README.md를 참조하세요.

Claude Desktop(claude_desktop_config.json): examples/claude_desktop_config.json을 참조하세요.

대표적인 사용 사례

• 스캔본 시험지를 MCP를 지원하는 AI 클라이언트에 넣으면 → 자동으로 텍스트로 인식 → 해설/교재 생성;

• 로컬 AI 워크벤치와 연동: AI가 pdf_text/pdf_ocr를 직접 호출하여 자료 폴더의 PDF를 읽습니다.

개발 계획

• 더 많은 파일 형식 지원(docx / xlsx)

• 드래그 앤 드롭 업로드(채팅창에 PDF를 직접 끌어다 놓기) — 호스트 클라이언트가 이미지가 아닌 첨부 파일을 지원해야 하며, 이 저장소에서의 협업을 환영합니다

• PDF 병합 / 분할 / 이미지 변환 일괄 처리

Related MCP server: MCP Server Knowledge Engine

영어

기능

CLI(pdf_tools.py)는 MCP 클라이언트 없이 동일한 기능을 제공합니다. pdf_drop_server.py는 AI 워크스페이스에 PDF를 공급하기 위한 의존성 없는 로컬 드래그 앤 드롭 받은편지함 웹 페이지를 추가합니다(호스트 측 첨부 파일 지원 불필요).

설치

pip install -r requirements.txt

사용법

CLI

python pdf_tools.py info    exam.pdf
python pdf_tools.py text    exam.pdf --pages 1-3
python pdf_tools.py ocr     scanned.pdf
python pdf_tools.py render  exam.pdf --pages 1-3
python pdf_tools.py find --dir ~/Downloads "final"

MCP 서버로 사용 — MCP를 지원하는 모든 클라이언트(DSH, Claude Desktop, Codex…)에 등록할 수 있습니다. 구성 예시는 examples/를 참조하세요.

로드맵

• 더 많은 파일 형식 지원(docx / xlsx)

• 채팅 UI에 드래그 앤 드롭 업로드(호스트 측에서 이미지가 아닌 첨부 파일 지원 필요 — 기여 환영)

• PDF 병합 / 분할 / 일괄 변환

라이선스

MIT