JamesFincher/PDFiTT

PDFiTT은(는) 무엇을 하나요?

오픈소스, 자체 호스팅 가능한 Markdown-to-PDF 생성 MCP로, 브라우저 UI, 직접 API, 휴대용 에이전트 스킬을 제공합니다.

특징

• Markdown-to-PDF 변환: Markdown 문서를 고품질 PDF로 변환합니다.
• 자체 호스팅: 완전한 데이터 제어와 프라이버시를 위해 로컬 서버에서 실행됩니다.
• 다중 인터페이스: 브라우저 UI, 직접 REST API, AI 에이전트 MCP 스킬을 지원합니다.
• 사용자 정의 가능: CSS 스타일, 페이지 크기, 여백, 머리글/바닥글을 지원합니다.
• 오픈소스: MIT 라이선스로 완전히 공개되어 있으며, 커스터마이징이 가능합니다.

빠른 시작

1. 저장소 클론

git clone https://github.com/JamesFincher/PDFiTT.git
cd PDFiTT

2. 종속성 설치

pip install -r requirements.txt

3. 서버 실행

python server.py

기본적으로 서버는 http://localhost:8080 에서 실행됩니다.

4. Markdown을 PDF로 변환

브라우저 UI 사용: http://localhost:8080 을 열고 Markdown을 입력란에 붙여넣거나 Markdown 파일을 업로드한 후 "PDF 생성"을 클릭하세요.

API 사용:

curl -X POST http://localhost:8080/convert \
  -H "Content-Type: application/json" \
  -d '{
    "markdown": "# Hello World\n\nThis is a **PDF** generated from Markdown.",
    "options": {
      "pageSize": "A4",
      "margin": "20mm"
    }
  }' --output output.pdf

5. 에이전트와 통합 (MCP)

이 스킬을 Claude Code, Cursor, Codex와 같은 AI 에이전트와 함께 사용하려면 에이전트 구성에서 MCP 도구로 등록하세요. 예를 들어 Claude Code의 claude.json:

{
  "mcpServers": {
    "pdfitt": {
      "command": "python",
      "args": ["server.py"],
      "env": {
        "HOST": "localhost",
        "PORT": "8080"
      }
    }
  }
}

API 참조

POST /convert

Markdown을 PDF로 변환합니다.

요청 본문:

필드	타입	필수	설명
markdown	문자열	예	변환할 Markdown 내용
options	객체	아니요	PDF 옵션 (아래 참조)

옵션 객체:

필드	타입	기본값	설명
pageSize	문자열	A4	페이지 크기 (A4, Letter, Legal 등)
margin	문자열	20mm	페이지 여백 (CSS 값)
header	문자열	없음	모든 페이지에 표시될 HTML 머리글
footer	문자열	없음	모든 페이지에 표시될 HTML 바닥글
css	문자열	없음	추가 CSS 스타일

라이선스

MIT