File Converter MCP Server

파일 변환기 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로 변환
• 일반 변환 : 다양한 형식 변환을 처리하려는 다목적 도구

기술

• 파이썬 3.10+
• 모델 컨텍스트 프로토콜(MCP) Python SDK
• 다양한 변환 라이브러리:
  • docx2pdf - DOCX를 PDF로 변환
  • pdf2docx - PDF를 DOCX로 변환
  • Pillow - 이미지 형식 변환용
  • pandas - Excel에서 CSV로 변환
  • pdfkit - HTML을 PDF로 변환
  • 마크다운 - 마크다운을 HTML로 변환

설치

1. 저장소 복제지엑스피1
2. 가상 환경 만들기(선택 사항이지만 권장)
   python -m venv venv source venv/bin/activate # On Unix-based systems venv\Scripts\activate # On Windows
3. 종속성 설치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 채팅 인터페이스를 통해 업로드된 파일과 원활하게 작동합니다.
• 상대 및 절대 파일 경로를 지원합니다.
• 가능한 경우 자동으로 파일 형식을 감지합니다.

듀얼 모드 입력

모든 변환 도구는 이제 두 가지 입력 방법을 지원합니다.

1. 경로 기반 전환 (전통적 접근 방식)
   @File Converter docx2pdf input_file: file.docx
2. 콘텐츠 기반 변환 (경로 조회가 실패하더라도 작동)
   @File Converter docx2pdf file_content_base64: [base64 encoded string]

이 듀얼 모드 접근 방식은 최대의 유연성과 안정성을 제공합니다.

• 의심스러운 경우 보장된 처리를 위해 콘텐츠 기반 입력을 사용하세요.
• 모든 중간 파일은 임시 디렉토리에 고유한 이름으로 생성됩니다.
• 임시 파일은 처리 후 자동으로 정리됩니다.

Claude 특정 파일 업로드 처리

Claude와 함께 사용할 때 파일 업로드를 찾을 수 없는 경우:

1. 원래 파일 이름에 선행 경로를 사용해 보세요.
   @File Converter docx2pdf input_file: /tmp/file.docx
2. 실패하면 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 (中文版(CONTRIBUTING.md), English: Contributing Guideline )의 지침을 따르세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

GitHub 저장소

https://github.com/wowyuarm/file-converter-mcp 에서 GitHub 저장소를 방문하세요.