PPTX MCP Server

PPTX MCP 서버

PowerPoint(PPTX) 프레젠테이션을 프로그래밍 방식으로 생성, 편집 및 렌더링하는 FastMCP 기반 서버입니다. 슬라이드 생성, 텍스트 및 도형 삽입, 이미지 삽입, PNG(LibreOffice 사용)로의 슬라이드 렌더링을 지원합니다.

특징

• 프레젠테이션 만들기/지우기: 새 PPTX 파일을 시작하거나 기존 PPTX 파일을 재설정합니다.
• 슬라이드 추가: 사용자 정의 가능한 레이아웃으로 슬라이드를 삽입합니다.
• 텍스트 및 콘텐츠: 슬라이드에 제목, 콘텐츠 및 사용자 지정 텍스트 상자를 추가합니다.
• 모양: 다양한 PowerPoint 모양(흐름도 요소 포함)을 삽입합니다.
• 이미지: 슬라이드에 이미지를 삽입합니다.
• 슬라이드 설명: 확인을 위해 슬라이드 내용의 텍스트 요약을 받으세요.
• 슬라이드 렌더링: 슬라이드를 PNG 이미지로 렌더링합니다(LibreOffice 필요).
• PPTX 다운로드: 생성된 프레젠테이션 파일을 다운로드합니다.

요구 사항

• 파이썬 3.12+
• 파이썬-pptx
• 베개
• 패스트MCP
• LibreOffice (슬라이드 이미지 렌더링용, 별도로 설치해야 하며 시스템 PATH에서 사용 가능해야 함)

설치

1. Python 종속성을 설치하세요:지엑스피1(또는 종속성에 대해서는 pyproject.toml 참조하세요)
2. LibreOffice 설치 (이미지 렌더링용):
   • Linux: sudo pacman -S libreoffice-fresh 또는 sudo apt install libreoffice
   • macOS: brew install --cask libreoffice
   • Windows: libreoffice.org에서 다운로드

용법

서버를 시작합니다:

환경 변수를 사용하여 서버의 호스트와 포트를 설정할 수 있습니다.

• HOST (기본값: 127.0.0.1 )
• PORT (기본값: 8000 )

예를 들어, 모든 인터페이스와 포트 9000에서 실행하려면 다음을 실행합니다.

또는 (FastMCP를 사용한 개발의 경우):

API 개요

서버는 FastMCP를 통해 다음을 포함한 도구와 리소스를 제공합니다.

• create_or_clear_presentation(filename)
• add_slide(filename, layout_index)
• add_title_and_content(filename, slide_index, title, content)
• add_textbox(filename, slide_index, text, left_inches, top_inches, width_inches, height_inches, font_size_pt, bold)
• add_shape(filename, slide_index, shape_type_name, left_inches, top_inches, width_inches, height_inches, text)
• add_picture(filename, slide_index, image, left_inches, top_inches, width_inches, height_inches)
• get_slide_content_description(filename, slide_index)
• get_slide_image(filename, slide_index)(LibreOffice 필요)
• get_pptx_file(filename)

전체 매개변수 세부 정보와 사용 가능한 모양 유형에 대한 내용은 코드를 참조하세요.

프레젠테이션 및 템플릿

• 프레젠테이션은 presentations/ 디렉토리에 저장됩니다.
• presentations/templates/ 에 나만의 템플릿을 추가할 수 있습니다.

특허

자세한 내용은 라이센스를 참조하세요.