PowerPoint Model Context Protocol (MCP) 서버

Python 기반의 Model Context Protocol (MCP) 서버로, fastmcp와 python-pptx를 사용하여 PowerPoint 프레젠테이션을 생성, 검사 및 편집하는 도구를 제공합니다.

사전 요구 사항

• Windows OS

• Python 3.12 (C:\Users\Lumbini_User\AppData\Local\Programs\Python\Python312에 이미 설치됨)

• 종속성이 설치된 로컬 가상 환경 .venv.

Related MCP server: Office-PowerPoint-MCP

노출된 도구

서버는 다음 도구를 등록하고 실행합니다:

1. create_presentation(path: str): 지정된 경로에 새 빈 PowerPoint 프레젠테이션을 생성합니다.

2. add_slide(path: str, layout_idx: int = 6): path의 프레젠테이션에 레이아웃 템플릿 인덱스(예: 빈 슬라이드의 경우 6)를 사용하여 새 슬라이드를 추가합니다.

3. add_text(path, slide_idx, text, left_in, top_in, width_in, height_in, font_name, font_size_pt, bold, italic, color_hex, align): 사용자 지정 서식이 적용된 텍스트 상자를 추가합니다.

4. add_bullet_points(path, slide_idx, points, left_in, top_in, width_in, height_in, font_name, font_size_pt, color_hex): 서식이 지정된 글머리 기호 목록을 추가합니다.

5. add_shape(path, slide_idx, shape_type, left_in, top_in, width_in, height_in, fill_color_hex, line_color_hex, line_width_pt): 사각형, 타원, 삼각형 등과 같은 기하학적 도형을 삽입합니다.

6. add_picture(path, slide_idx, image_path, left_in, top_in, width_in, height_in): 로컬 이미지를 삽입합니다.

7. add_table(path, slide_idx, rows, cols, left_in, top_in, width_in, height_in, data): 테이블을 삽입하고 데이터를 채웁니다.

8. get_presentation_info(path): 모든 슬라이드의 상세 구조, 도형 위치, 텍스트 및 테이블을 반환합니다.

9. search_replace_text(path, search_str, replace_str): 전체 프레젠테이션에서 텍스트 상자, 도형 및 테이블에 걸쳐 찾기 및 바꾸기를 수행합니다.

10. delete_slide(path, slide_idx): 지정된 인덱스의 슬라이드를 삭제합니다.

MCP 클라이언트 구성

이 서버를 MCP 호스트(예: Claude Desktop 또는 cursor)에 등록하려면 호스트 구성 파일에 다음 항목을 추가하십시오:

{
  "mcpServers": {
    "powerpoint": {
      "command": "c:\\Users\\Lumbini_User\\Desktop\\PPT\\.venv\\Scripts\\python.exe",
      "args": [
        "c:\\Users\\Lumbini_User\\Desktop\\PPT\\ppt_mcp_server.py"
      ],
      "env": {}
    }
  }
}

로컬 개발 및 테스트

1. 가상 환경을 활성화합니다:

   .venv\Scripts\Activate.ps1

2. 서버를 직접 실행합니다:

   python ppt_mcp_server.py