FileToPDF

공식

파일(DOCX, XLSX, PPTX, 이미지), HTML 및 Markdown을 픽셀 완벽한 PDF로 변환 — npx stdio 또는 호스팅된 Streamable HTTP, 무료 API 키 한 번 클릭.

GitHub

File To PDF MCP(으)로 무엇을 할 수 있나요?

계정 상태 및 남은 크레딧 확인 — 어시스턴트에게 get_account를 호출하도록 요청하여 API 키, 요금제 등급 및 변환 잔액을 확인하세요.
공개 호스팅 파일을 PDF로 변환 — DOCX, XLSX, PPTX, 이미지, HTML 또는 MD 파일의 URL을 제공하면 convert_file이 PDF를 반환합니다.
HTML 문자열을 PDF로 렌더링 — 선택적 CSS 및 레이아웃 옵션과 함께 원시 HTML을 convert_html에 전달하여 Chromium 기반의 픽셀 완벽한 출력을 생성하세요.
Markdown을 깔끔한 PDF로 변환 — 선택적 스타일링 및 레이아웃 제어와 함께 Markdown 문자열을 convert_markdown에 보내세요.
생성된 PDF를 디스크에 저장 — FILETOPDF_OUTPUT_DIR 환경 변수를 설정하거나 save_path를 전달하여 PDF 파일을 로컬에 저장하세요.

문서

FileToPDF MCP 서버

FileToPDF를 위한 모델 컨텍스트 프로토콜 서버입니다. Claude Desktop, Claude Code, Cursor, Cline, VS Code, ChatGPT, n8n, Make 또는 자체 에이전트 등 모든 MCP 클라이언트가 자연어를 통해 파일, HTML, 마크다운을 PDF로 변환할 수 있게 해줍니다. 송장, 보고서, 문서, DOCX/XLSX/PPTX, 이미지, 웹 페이지 등 다양한 형식을 지원합니다.

자신의 API 키를 가져오세요 — https://filetopdf.dev에서 클릭 한 번으로 무료로 받을 수 있습니다 (가입 없이 10회 무료 변환 제공).

도구

도구	기능
`get_account`	API 키를 확인하고 플랜과 남은 크레딧을 표시합니다. 무료이며 크레딧이 소모되지 않습니다.
`convert_file`	공개 URL의 파일(DOCX, XLSX, PPTX, 이미지, HTML, MD, PDF 등)을 PDF로 변환합니다.
`convert_html`	원시 HTML 문자열(선택적 CSS + 레이아웃 옵션 포함)을 Chromium을 통해 픽셀 단위까지 완벽한 PDF로 렌더링합니다.
`convert_markdown`	원시 마크다운 문자열(선택적 CSS + 레이아웃 옵션 포함)을 깔끔한 PDF로 렌더링합니다.

각 변환 도구는 메타데이터 요약 및 PDF를 임베디드 application/pdf 리소스(base64)로 반환하므로, 지원되는 클라이언트는 파일을 저장할 수 있습니다. FILETOPDF_OUTPUT_DIR 환경 변수를 설정하거나 save_path를 전달하여 PDF를 디스크에도 저장할 수 있습니다.

레이아웃 옵션(landscape, paperWidth/Height, 여백, scale, pdfa, 비밀번호 등)은 Pro, Scale 및 무료 체험판에서 사용할 수 있으며, Starter/Basic에서는 업그레이드 오류가 반환됩니다. 성공적인 변환마다 1 크레딧이 소모되며, 오류는 무료입니다.

빠른 시작 (로컬 / stdio)

Cursor — 원클릭 설치: Cursor에 추가 (그런 다음 자리 표시자를 키로 교체하세요).

Claude Desktop / Cline / 모든 stdio 클라이언트 — MCP 구성에 추가하세요 (claude_desktop_config.json, cline_mcp_settings.json 등):

{
  "mcpServers": {
    "filetopdf": {
      "command": "npx",
      "args": ["-y", "filetopdf-mcp"],
      "env": { "FILETOPDF_API_KEY": "sk_live_YOUR_API_KEY" }
    }
  }
}

Claude Code:

claude mcp add filetopdf -e FILETOPDF_API_KEY=sk_live_YOUR_API_KEY -- npx -y filetopdf-mcp

VS Code (.vscode/mcp.json 또는 MCP: 서버 추가를 통해):

{
  "servers": {
    "filetopdf": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "filetopdf-mcp"],
      "env": { "FILETOPDF_API_KEY": "sk_live_YOUR_API_KEY" }
    }
  }
}

호스팅 / 원격 (Streamable HTTP) — 설치 불필요

호스팅된 엔드포인트를 **https://api.filetopdf.dev/mcp**에서 사용할 수 있습니다. x-api-key 헤더, Authorization: Bearer 헤더 또는 ?apiKey= 쿼리 매개변수를 통해 자신의 키로 인증하세요.

{
  "mcpServers": {
    "filetopdf": {
      "type": "streamable-http",
      "url": "https://api.filetopdf.dev/mcp",
      "headers": { "x-api-key": "sk_live_YOUR_API_KEY" }
    }
  }
}

이 URL은 MCP 클라이언트 단계가 있는 모든 플랫폼에 붙여넣을 수 있는 주소이기도 합니다 — n8n (MCP 클라이언트 도구), Make (MCP 클라이언트), Zapier (MCP 클라이언트 베타), Relay.app (MCP 도구 호출), Flowise, Langflow, Dify, LibreChat, AnythingLLM, 또는 에이전트 프레임워크(OpenAI Agents SDK, LangChain, CrewAI, Vercel AI SDK).

대신 자체 호스팅하려면:

npm run build && npm run start:http   # listens on $PORT (default 8080) at /mcp

컨테이너 호스팅(Smithery, Fly, Render, Cloud Run)을 위한 Dockerfile이 포함되어 있습니다.

개발 및 테스트

npm install
npm run build          # tsc -> dist/
npm test               # spawns the built stdio server, runs a live conversion

npm test는 FILETOPDF_API_KEY 또는 gitignored된 .env에서 API_KEY=를 읽습니다.

링크

웹사이트 및 즉시 사용 가능한 무료 API 키: https://filetopdf.dev
API 문서: https://filetopdf.dev/documentation
공식 MCP 레지스트리 이름: dev.filetopdf/filetopdf-mcp

라이선스

MIT