PptMcp - Microsoft PowerPoint용 MCP 서버

AI로 PowerPoint 자동화 — 대화형 AI를 통한 포괄적인 PowerPoint 자동화를 위한 Model Context Protocol (MCP) 서버.

PptMcp는 GitHub Copilot, Claude, ChatGPT와 같은 AI 어시스턴트가 자연어 명령을 통해 Microsoft PowerPoint를 자동화할 수 있게 해줍니다. 실제 프레젠테이션 작업을 처음부터 끝까지 다룹니다: 슬라이드 생성, 텍스트 편집, 도형 및 이미지 배치, 차트 및 표 작성, 테마 적용, VBA 실행, PDF 또는 비디오로 내보내기, 그리고 네이티브 COM API를 통해 라이브 PowerPoint 창을 안전하게 관리합니다.

기원 및 크레딧: 이 프로젝트는 Stefan Broenner (sbroenne) 가 만든 mcp-server-excel의 원래 MCP 자동화 기반을 바탕으로, PowerPoint 중심의 완전한 도구 체인으로 확장한 것입니다.

릴리스 및 패키지: GitHub Releases | NuGet: PptMcp.McpServer | NuGet: PptMcp.CLI

소스에서 다단계 빌드/검증/수리 워크플로우를 위해, 저장소에는 src\PptMcp.Agent 아래 공식 오케스트레이션 클라이언트도 포함되어 있습니다.

🛡️ 100% 안전 — PowerPoint의 네이티브 COM API 사용 — 파일 손상 위험 제로. PowerPoint의 공식 COM API를 사용하여 완전한 안전성과 호환성을 보장합니다.

💡 대화형 개발 — PowerPoint에서 결과를 즉시 확인하세요. 슬라이드 추가, 차트 생성, 텍스트 서식 지정, 반복 작업. PowerPoint가 AI 기반 작업 공간이 됩니다.

기술 요구 사항:

• ⚠️ Windows 전용 — COM interop은 Windows 전용입니다

• ⚠️ PowerPoint 필요 — Microsoft PowerPoint 2016 이상이 설치되어 있어야 합니다

• ⚠️ 데스크톱 환경 — 실제 PowerPoint 프로세스를 제어합니다 (서버 측 처리가 아님)

🎯 할 수 있는 작업

223개의 작업을 가진 33개의 특수 도구:

• 📁 파일 (1개 도구, 6개 작업) — 프레젠테이션 열기, 닫기, 만들기, 저장, 나열, 검증

• 📄 슬라이드 (1개 도구, 15개 작업) — 만들기, 복제, 이동, 삭제, 레이아웃 적용, 숨기기/숨기기 해제, 축소판, 복제-대체

• 🔷 도형 (1개 도구, 35개 작업) — 추가, 이동, 크기 조정, 채우기, 그라데이션, 선, 그림자, 광택, 반사, 불투명도, 3D, 회전, z-순서, 그룹화, 연결선, 병합, 뒤집기, 배율

• ✏️ 텍스트 (1개 도구, 18개 작업) — 텍스트 가져오기/설정, 찾기, 바꾸기, 서식, 간격, 글머리 기호, 대/소문자, 기호, 대체 텍스트 감사

• 📋 슬라이드 표 (1개 도구, 13개 작업) — 만들기, 셀 및 행 읽기/쓰기, 행/열 추가/삭제, 병합, 서식, 테두리

• 📊 차트 (1개 도구, 10개 작업) — 만들기, 데이터 설정, 제목, 유형, 범례, 축 제목, 데이터 테이블

• 🖼️ 이미지 (1개 도구, 4개 작업) — 삽입, 자르기, 밝기/대비, 투명 색상

• 🎥 미디어 (1개 도구, 4개 작업) — 오디오/비디오 삽입, 미디어 정보, 재생 설정

• 🧩 SmartArt (1개 도구, 6개 작업) — 다이어그램 정보, 노드 추가/삭제, 레이아웃, 스타일, 수준 변경

• 🎨 디자인/테마 (1개 도구, 19개 작업) — 테마, 색 구성표, 글꼴, 아키타입, 팔레트, 레이아웃 그리드, 스타일 프로필

• 🖌️ 슬라이드 배경 (1개 도구, 5개 작업) — 가져오기, 단색, 그라데이션, 이미지, 마스터로 재설정

• 🎭 마스터 및 레이아웃 (1개 도구, 5개 작업) — 마스터 및 레이아웃 나열, 마스터 도형 편집, 사용하지 않는 항목 삭제

• 📌 자리 표시자 (1개 도구, 3개 작업) — 자리 표시자 나열, 텍스트 설정, 이미지 설정

• 📃 머리글 및 바닥글 (1개 도구, 2개 작업) — 바닥글 텍스트, 슬라이드 번호, 날짜 가져오기/설정

• 📐 페이지 설정 (1개 도구, 3개 작업) — 슬라이드 크기, 방향, 첫 번째 슬라이드 번호

• ↔️ 도형 정렬 (1개 도구, 2개 작업) — 슬라이드에서 도형 정렬 및 분산

• 🎬 애니메이션 (1개 도구, 6개 작업) — 나열, 추가, 제거, 지우기, 타이밍, 순서 변경

• 🔀 전환 (1개 도구, 4개 작업) — 가져오기, 설정, 제거, 모든 슬라이드에 복사

• 📺 슬라이드 쇼 (1개 도구, 5개 작업) — 시작, 중지, 탐색, 상태, 구성

• 🎞️ 사용자 지정 쇼 (1개 도구, 3개 작업) — 사용자 지정 슬라이드 쇼 만들기, 나열, 삭제

• 📂 섹션 (1개 도구, 4개 작업) — 프레젠테이션 섹션 나열, 추가, 이름 바꾸기, 삭제

• 📥 슬라이드 가져오기 (1개 도구, 1개 작업) — 다른 .pptx 파일에서 슬라이드 가져오기

• 📝 메모 (1개 도구, 5개 작업) — 가져오기, 설정, 지우기, 추가, 모든 발표자 노트 읽기

• 💬 주석 (1개 도구, 4개 작업) — 슬라이드 주석 추가, 나열, 삭제, 지우기

• 🔗 하이퍼링크 (1개 도구, 5개 작업) — 하이퍼링크 추가, 가져오기, 나열, 제거, 검증

• 🏷️ 태그 (1개 도구, 3개 작업) — 슬라이드 및 도형의 사용자 지정 메타데이터

• 🗂️ 문서 속성 (1개 도구, 4개 작업) — 기본 제공 및 사용자 지정 속성 가져오기/설정

• ♿ 접근성 (1개 도구, 3개 작업) — 감사, 읽기 순서 가져오기/설정

• 🔤 맞춤법 검사 (1개 도구, 3개 작업) — 맞춤법 검사, 언어 가져오기/설정

• 📤 내보내기 (1개 도구, 9개 작업) — PDF, 슬라이드 이미지, 비디오 (MP4), 인쇄, 다른 이름으로 저장, 텍스트/이미지 추출

• 🖨️ 인쇄 옵션 (1개 도구, 2개 작업) — 인쇄 구성 가져오기/설정

• ⚙️ VBA (1개 도구, 5개 작업) — 매크로 나열, 보기, 가져오기, 삭제, 실행

• 🪟 창 (1개 도구, 7개 작업) — 정보, 최소화, 복원, 최대화, 확대/축소, 보기 모드

📚 전체 기능 참조 → — 223개 작업에 대한 자세한 문서

Related MCP server: Office-PowerPoint-MCP

💬 예시 프롬프트

프레젠테이션 만들기 및 작성:

• "QuarterlyReport.pptx라는 새 PowerPoint 프레젠테이션을 제목 슬라이드와 함께 만드세요"

• "'제목 및 콘텐츠' 레이아웃으로 슬라이드 5개를 추가하세요"

• "첫 번째 슬라이드에 회사 로고 이미지를 삽입하세요"

콘텐츠 및 서식:

• "슬라이드 2에 'Q1 매출 요약'이라는 텍스트를 굵은 24pt Arial로 텍스트 상자를 추가하세요"

• "슬라이드 3에 지역, Q1, Q2, Q3, Q4 열이 있는 표를 만드세요"

• "도형 채우기 색상을 #0078D4로 설정하고 2pt 테두리를 추가하세요"

차트 및 시각 자료:

• "슬라이드 4에 분기별 매출 데이터를 보여주는 막대 차트를 만드세요"

• "차트 제목을 '분기별 매출'로 설정하세요"

• "차트 도형에 나타나기 애니메이션을 추가하세요"

자동화:

• "프레젠테이션을 PDF로 내보내세요"

• "FormatAllSlides 매크로를 실행하세요"

• "작업하는 동안 PowerPoint를 보여주세요" — 변경 사항을 실시간으로 확인

🪟 에이전트 모드 — AI가 PowerPoint에서 작업하는 것을 지켜보세요:

• "이 프레젠테이션을 만드는 동안 PowerPoint를 나란히 보여주세요" — 실시간 가시성

• "슬라이드를 만드는 동안 지켜볼 수 있게 해주세요"

• 상태 표시줄에 실시간 진행 상황이 표시됩니다: "PptMcp: 슬라이드 4에 차트 만드는 중..."

👥 누가 사용해야 하나요?

적합한 대상:

• ✅ 발표자 — 반복적인 PowerPoint 워크플로우 자동화

• ✅ 개발자 — PowerPoint 기반 보고 솔루션 구축

• ✅ 비즈니스 사용자 — 복잡한 프레젠테이션 덱 관리

• ✅ 팀 — 프레젠테이션 템플릿 및 VBA 매크로 유지 관리

적합하지 않은 대상:

• ❌ 서버 측 처리 (Open XML SDK와 같은 라이브러리 사용)

• ❌ Linux/macOS 사용자 (Windows + PowerPoint 설치 필요)

• ❌ 대량 배치 작업 (PowerPoint 없는 대안 고려)

🚀 빠른 시작

⚠️ 중요: 사용하기 전에 모든 PowerPoint 파일을 닫으세요. 서버는 자동화 중에 프레젠테이션에 대한 독점 액세스가 필요합니다.

🔧 CLI vs MCP 서버

이 패키지는 CLI 및 MCP 서버 인터페이스를 모두 제공합니다. 사용 사례에 따라 선택하세요:

수동 설치:

# Install MCP Server and CLI
dotnet tool install --global PptMcp.McpServer
dotnet tool install --global PptMcp.CLI

🤖 선택 사항: 소스의 공식 에이전트 클라이언트

더 큰 덱 구축 작업을 위해, 이 저장소에는 공식 소스 측 컨트롤러인 src\PptMcp.Agent도 포함되어 있습니다.

의도적으로 세 번째 서버 표면이 아닙니다. 대신 MCP 서버 위에 위치하며 클라이언트 측 루프를 실행합니다:

• 덱 계획

• 일반적인 순차 MCP 도구 호출을 통해 실행

• 생성된 덱 검증

• 필요한 경우 불완전한 출력 수리

빠른 시작:

dotnet build src\PptMcp.McpServer\PptMcp.McpServer.csproj -c Release

Set-Location src\PptMcp.Agent
npm install
npm run check
npm test

node .\src\cli.mjs run `
  --task "Build a 5-slide executive deck on Q4 revenue performance and next actions." `
  --output "C:\Users\you\Documents\q4-revenue-deck.pptx"

더 읽어보기:

• 에이전트 클라이언트 구성 요소 README

• 에이전트 클라이언트 아키텍처

• 평가 프레임워크

• 아키타입 파이프라인

⚙️ 작동 방식 — COM 자동화 및 통합 서비스 아키텍처

PptMcp는 Windows COM 자동화를 사용하여 실제 PowerPoint 응용 프로그램을 제어합니다 (.pptx 파일만이 아님).

MCP 서버와 CLI 모두 PowerPoint 세션을 관리하는 공유 PptMcp 서비스와 통신합니다. 이 통합 아키텍처는 다음을 가능하게 합니다:

┌─────────────────────┐     ┌─────────────────────┐
│   MCP Server        │     │   CLI (pptcli)    │
│  (AI assistants)    │     │  (coding agents)    │
└─────────┬───────────┘     └─────────┬───────────┘
          │                           │
          └──────────┬────────────────┘
                     ▼
          ┌─────────────────────────┐
          │   PptMcp Service      │
          │  (shared session mgmt)  │
          └─────────┬───────────────┘
                    ▼
          ┌─────────────────────────┐
          │   PowerPoint COM API    │
          │  (PowerPoint.Application)│
          └─────────────────────────┘

주요 이점:

• ✅ 공유 세션 — CLI와 MCP 서버가 동일한 열린 프레젠테이션에 액세스할 수 있습니다

• ✅ 단일 PowerPoint 인스턴스 — 중복 프로세스 또는 파일 잠금 없음

• ✅ 시스템 트레이 UI — PptMcp 트레이 아이콘을 통해 활성 세션 모니터링

💡 팁: AI가 작업하는 동안 PowerPoint를 지켜보세요 기본적으로 PowerPoint는 더 빠른 자동화를 위해 숨겨져 실행됩니다. 변경 사항을 실시간으로 보려면 다음을 요청하세요:

• "작업하는 동안 PowerPoint를 보여주세요"

• "무엇을 하고 있는지 지켜볼 수 있게 해주세요"

• "변경 사항을 볼 수 있도록 PowerPoint를 여세요"

AI가 PowerPoint 창을 표시하여 모든 작업이 실시간으로 일어나는 것을 볼 수 있습니다!

📋 추가 정보

📚 CLI 가이드 → | MCP 서버 가이드 → | 에이전트 클라이언트 → | 평가 프레임워크 → | 아키타입 파이프라인 → | 모든 에이전트 스킬 →

라이선스: MIT 라이선스 - LICENSE 파일 참조

기여: 지침은 CONTRIBUTING.md 참조

제작 도구: 이 전체 프로젝트는 GitHub Copilot AI 지원으로 개발되었습니다 - 주로 Claude와 함께, 최근에는 Auto-mode로.

감사의 말:

• Microsoft PowerPoint 팀 — 포괄적인 COM 자동화 API 제공

• Model Context Protocol 커뮤니티 — AI 통합 표준 제공

• 오픈 소스 커뮤니티 — 영감과 모범 사례 제공

관련 프로젝트

Stefan Broenner의 업스트림 프로젝트:

• mcp-server-excel (업스트림) — Stefan Broenner의 원래 Excel용 MCP 서버

• pytest-aitest — AI 에이전트용 LLM 기반 테스트 프레임워크