powerpoint-mcp-live

열려 있는 PowerPoint 프레젠테이션을 편집하세요 — AI는 이미 열려 있는 창에 연결되며, 자체적으로 새 창을 시작하지 않습니다.

실시간 편집 · Windows (COM) · 23개 도구

대부분의 PowerPoint MCP 서버(이 워크스페이스의 자체 mcp-server-powerpoint 포함)는 새롭고 보이지 않는 PowerPoint 프로세스를 시작하고, 그 안에서 파일을 연 다음, 완료되면 다시 닫는 방식으로 작동합니다. 이는 스크립트 기반 데크 생성에는 훌륭하지만, AI가 사용자가 보고 있는 동일한 창을 바라보지 않는다는 것을 의미합니다.

powerpoint-mcp-live는 그 반대입니다. word-mcp-live 및 excel-mcp-live와 동일한 "실행 중인 응용 프로그램 찾기" 방식을 사용하여 COM을 통해 이미 열려 있는 PowerPoint 창에 연결합니다. PowerPoint를 시작하거나 닫지 않으며, 사용자가 직접 연 프레젠테이션에만 접근합니다.

요구 사항

• Windows (COM 자동화는 Windows 전용입니다 — 이 프로젝트에는 macOS/Linux 모드가 없습니다)

• Microsoft PowerPoint가 설치되어 있고 프레젠테이션이 열린 상태로 이미 실행 중이어야 합니다

• Python 3.11+

Related MCP server: mcp-powerpoint

설치

git clone <this-repo-url>
cd powerpoint-mcp-live
pip install -e .

또는 uv로 소스에서 직접 실행하세요 — 설치 단계가 필요 없습니다:

uv run powerpoint_mcp_server.py

클라이언트 설정 (.mcp.json)

MCP 클라이언트를 프로젝트 디렉터리로 지정하세요. Claude Code의 경우, 프로젝트의 .mcp.json(또는 사용자 전체 설정의 경우 ~/.claude.json)에 다음을 추가하세요:

{
  "mcpServers": {
    "powerpoint-live": {
      "command": "uv",
      "args": [
        "--directory",
        "G:/Ai/MCP/powerpoint-mcp-live",
        "run",
        "powerpoint_mcp_server.py"
      ],
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

대신 pip install -e .로 설치한 경우 콘솔 스크립트를 직접 사용할 수 있습니다:

{
  "mcpServers": {
    "powerpoint-live": {
      "command": "powerpoint-mcp-live",
      "env": {
        "MCP_AUTHOR": "Your Name",
        "MCP_AUTHOR_INITIALS": "YN"
      }
    }
  }
}

MCP_AUTHOR / MCP_AUTHOR_INITIALS는 새 슬라이드 주석에 첨부되는 작성자 이름/이니셜을 설정합니다(기본값: "Author" / "").

지원되는 함수

모든 도구는 PowerPoint에서 이미 열려 있는 프레젠테이션에서 작동합니다. presentation은 거의 모든 곳에서 선택 사항입니다 — 생략하면 활성 프레젠테이션을 대상으로 합니다.

아직 지원되지 않음: 표, 차트, SmartArt, 애니메이션, 전환, 템플릿/테마 — 이러한 경우 자체 PowerPoint 인스턴스를 시작하고 훨씬 더 광범위한 작업 범위를 제공하는 mcp-server-powerpoint를 사용하세요.

예시 프롬프트

"I have this deck open — read the text on slide 3 and tell me if the bullets are too long."
"Add a new slide after slide 2 with a blank layout."
"Add a text box on slide 4 that says 'Draft — do not distribute' in red."
"Make the title on slide 1 bold and increase it to 44pt."
"Export slide 5 as an image so I can check whether anything overlaps."
"Add a comment on slide 3 asking if the chart numbers are up to date."

알려진 제한 사항

• Windows 전용. PowerPoint COM 자동화는 macOS/Linux에 존재하지 않습니다.

• 프레젠테이션이 PowerPoint에서 이미 열려 있어야 합니다. 이 서버는 파일을 만들거나 열지 않습니다 — 해당 기능은 mcp-server-powerpoint를 참조하세요.

• 단일 실행 취소 그룹화 없음. Word의 COM API는 여러 편집을 한 번의 Ctrl+Z로 묶을 수 있지만 PowerPoint는 그럴 수 없습니다(Excel도 마찬가지). 여러 쓰기를 수행하는 도구 호출은 완전히 실행 취소하려면 여러 번의 Ctrl+Z가 필요할 수 있습니다.

• 주석은 PowerPoint 2016+ 필요 (최신 스레드형 주석).

개발

아키텍처 참고 사항 및 설계 제약 조건은 CLAUDE.md를 참조하세요 — 특히 이 서버가 PowerPoint 자체를 시작하거나 종료해서는 안 되는 이유에 대해 설명합니다.