파일 변환기 MCP 서버
간체 중국어 | 영어
이 MCP 서버는 다양한 문서 및 이미지 형식을 변환하는 데 필요한 여러 파일 변환 도구를 제공합니다. 이 프로젝트는 모델 컨텍스트 프로토콜(MCP)을 사용하여 구축되었으며, 파일 변환 기능이 필요한 AI 에이전트를 지원하도록 설계되었습니다.
특징
DOCX를 PDF로 변환: Microsoft Word 문서를 PDF로 변환
PDF를 DOCX로 변환: PDF 문서를 Microsoft Word 형식으로 변환
이미지 형식 변환 : 다양한 이미지 형식(JPG, PNG, WebP 등) 간에 변환합니다.
Excel에서 CSV로 변환: Excel 스프레드시트를 CSV 형식으로 변환
HTML을 PDF로 변환: HTML 파일을 PDF 형식으로 변환
마크다운을 PDF로 변환: 적절한 스타일을 적용하여 마크다운 문서를 PDF로 변환
일반 변환 : 다양한 형식 변환을 처리하려는 다목적 도구
Related MCP server: PDF Generator API MCP Server
기술
파이썬 3.10+
다양한 변환 라이브러리:
설치
저장소 복제
지엑스피1
가상 환경 만들기(선택 사항이지만 권장)
python -m venv venv source venv/bin/activate # On Unix-based systems venv\Scripts\activate # On Windows종속성 설치
pip를 사용하여 필요한 패키지를 설치하세요:
pip install mcp docx2pdf pdf2docx pillow pandas pdfkit markdown또는 uv를 사용하는 경우:
uv add "mcp[cli]" docx2pdf pdf2docx pillow pandas pdfkit markdown참고: 일부 변환 라이브러리에는 추가적인 시스템 종속성이 있을 수 있습니다. 자세한 내용은 해당 문서를 확인하세요.
용법
개발 모드에서 서버 실행
서버를 테스트하려면 다음을 실행하세요.
Claude Desktop 설치
선택적으로 다음을 사용하여 Claude Desktop에 서버를 설치할 수 있습니다.
API / 도구
MCP 서버는 다음 도구를 제공합니다.
경로 기반 도구(콘텐츠 입력도 지원)
docx2pdf
명령어: docx2pdf
입력 옵션 1 : .docx 파일 경로
input_file: path/to/document.docx입력 옵션 2 : DOCX 파일의 Base64 인코딩된 콘텐츠
file_content_base64: [base64 encoded string]출력 : 변환된 PDF 파일의 Base64 인코딩된 문자열
pdf2docx
명령어: pdf2docx
입력 옵션 1 : PDF 파일 경로
input_file: path/to/document.pdf입력 옵션 2 : PDF 파일의 Base64 인코딩된 콘텐츠
file_content_base64: [base64 encoded string]출력 : 변환된 DOCX 파일의 Base64 인코딩된 문자열
이미지 변환
명령어: convert_image
입력 옵션 1 :
input_file: path/to/image.png output_format: jpg입력 옵션 2 :
file_content_base64: [base64 encoded string] input_format: png output_format: jpg출력 : 변환된 이미지의 Base64 인코딩된 문자열
엑셀2CSV
명령어: excel2csv
입력 : Excel 파일(.xls 또는 .xlsx) 경로
출력 : 변환된 CSV 파일의 Base64 인코딩된 문자열
HTML2PDF
명령어: html2pdf
입력 : HTML 또는 Markdown 파일(.html, .md, .markdown) 경로
출력 : 변환된 PDF 파일의 Base64 인코딩된 문자열
convert_file(일반 변환기)
명령어: convert_file
입력 옵션 1 :
input_file: path/to/file.docx input_format: docx output_format: pdf입력 옵션 2 :
file_content_base64: [base64 encoded string] input_format: docx output_format: pdf출력 : 변환된 파일의 Base64 인코딩된 문자열
콘텐츠 기반 도구(레거시)
이러한 기능은 이전 버전과의 호환성을 위해 유지됩니다. 모든 주요 도구는 이제 콘텐츠 기반 입력을 직접 지원합니다.
convert_content(일반 콘텐츠 변환기)
명령어: convert_content
입력 :
입력 파일의 Base64 인코딩된 콘텐츠
소스 형식(예: "docx", "pdf", "md")
대상 형식(예: "pdf", "docx")
출력 : 변환된 파일의 Base64 인코딩된 문자열
docx2pdf_콘텐츠
명령어: docx2pdf_content
입력 : DOCX 파일의 Base64 인코딩된 콘텐츠
출력 : 변환된 PDF 파일의 Base64 인코딩된 문자열
pdf2docx_콘텐츠
명령어: pdf2docx_content
입력 : PDF 파일의 Base64 인코딩된 콘텐츠
출력 : 변환된 DOCX 파일의 Base64 인코딩된 문자열
마크다운2pdf_콘텐츠
명령어: markdown2pdf_content
입력 : Markdown 파일의 Base64 인코딩된 콘텐츠
출력 : 변환된 PDF 파일의 Base64 인코딩된 문자열
파일 처리
서버에는 다음과 같은 강력한 파일 경로 처리 기능이 포함되어 있습니다.
다단계 검색 전략을 사용하여 파일을 찾습니다.
공통 위치(임시 디렉토리, 현재 디렉토리)에 업로드된 파일을 검색합니다.
여러 파일 이름 변형을 시도합니다(대소문자 구분 없음, 확장자 포함/미포함)
파일 위치 문제 해결에 도움이 되는 자세한 로그를 제공합니다.
Claude 채팅 인터페이스를 통해 업로드된 파일과 원활하게 작동합니다.
상대 및 절대 파일 경로를 지원합니다.
가능한 경우 자동으로 파일 형식을 감지합니다.
듀얼 모드 입력
모든 변환 도구는 이제 두 가지 입력 방법을 지원합니다.
경로 기반 전환 (전통적 접근 방식)
@File Converter docx2pdf input_file: file.docx콘텐츠 기반 변환 (경로 조회가 실패하더라도 작동)
@File Converter docx2pdf file_content_base64: [base64 encoded string]
이 듀얼 모드 접근 방식은 최대의 유연성과 안정성을 제공합니다.
의심스러운 경우 보장된 처리를 위해 콘텐츠 기반 입력을 사용하세요.
모든 중간 파일은 임시 디렉토리에 고유한 이름으로 생성됩니다.
임시 파일은 처리 후 자동으로 정리됩니다.
Claude 특정 파일 업로드 처리
Claude와 함께 사용할 때 파일 업로드를 찾을 수 없는 경우:
원래 파일 이름에 선행 경로를 사용해 보세요.
@File Converter docx2pdf input_file: /tmp/file.docx실패하면 Claude에게서 직접 파일 내용을 얻으세요.
@File Converter docx2pdf file_content_base64: [base64 content obtained from Claude]
오류 처리
각 도구는 여러 검색 전략을 사용하여 파일 존재 여부를 확인합니다.
자세한 오류 메시지는 구조화된 JSON 형식으로 반환됩니다.
{"success": false, "error": "error message"}성공적인 변환은
{"success": true, "data": "base64 encoded file content"}반환합니다.서버에는 문제 해결을 위한 포괄적인 로깅이 포함되어 있습니다.
서버는 예외를 우아하게 처리하고 유익한 오류 메시지를 반환합니다.
기여하다
기여를 환영합니다! 기여하고 싶다면 CONTRIBUTING.md (中文版:贡献指南, English: Contributing Guideline )의 지침을 따르세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
GitHub 저장소
https://github.com/wowyuarm/file-converter-mcp 에서 GitHub 저장소를 방문하세요.