Google Slides MCP Server

이 프로세스는 Google Slides API용 MCP 서버입니다. 호스트가 stdio를 통해 통신합니다. 첫 번째 시작 시 브라우저가 열립니다. Desktop 클라이언트 ID와 클라이언트 시크릿을 붙여넣습니다. 이후 Google 동의 화면이 이어집니다. 이후 시작 시에는 토큰 저장소를 읽습니다.

사전 요구 사항

• Node.js 20 이상

• Google Slides API가 활성화된 Google Cloud 프로젝트

• OAuth Desktop 클라이언트 ID 및 클라이언트 시크릿

리프레시 토큰이 필요하지 않습니다. 프로세스 환경 변수도 필요하지 않습니다.

Related MCP server: Google Slides MCP Server

Claude Code

1. Desktop OAuth 클라이언트를 만듭니다. 아래의 Google Auth 플랫폼 단계를 따르세요.

2. Claude Code에서 다음을 실행합니다:

/plugin marketplace add matteoantoci/claude-plugins
/plugin install google-slides-mcp@matteoantoci-plugins

3. Claude가 요청하면 /reload-plugins를 실행합니다.

4. 첫 번째 시작 시 브라우저가 열립니다. 클라이언트 ID와 클라이언트 시크릿을 붙여넣습니다. Google 동의를 완료합니다.

이후 세션에서는 토큰 저장소를 읽습니다. 호스트 JSON이 없습니다. 환경 변수도 없습니다.

다른 호스트

1. 이 저장소를 클론합니다.

2. npm install을 실행합니다.

3. npm run build를 실행합니다.

4. Google Cloud Console에서 Desktop OAuth 클라이언트를 만듭니다:

   • Google Auth platform을 엽니다.

   • 페이지에 플랫폼이 구성되지 않았다고 표시되면 시작하기를 클릭합니다.

   • 앱 이름: Google Slides MCP. 사용자 지원 이메일: 본인 이메일 주소.

   • 사용자 유형: 외부.

   • 연락처 이메일: 본인 이메일 주소. 정책에 동의합니다. 만들기를 클릭합니다.

   • Audience를 엽니다. 본인 Gmail을 테스트 사용자로 추가합니다.

   • Data Access를 엽니다. https://www.googleapis.com/auth/presentations 및 https://www.googleapis.com/auth/drive.readonly를 추가합니다. 저장합니다.

   • Clients를 엽니다. 클라이언트 만들기를 클릭합니다. 애플리케이션 유형: 데스크톱 앱. 이름: Google Slides MCP Desktop. 만들기를 클릭합니다.

   • 클라이언트 ID와 클라이언트 시크릿을 복사합니다.

5. npm run start를 실행합니다. 클라이언트 ID와 클라이언트 시크릿을 붙여넣습니다. Google 동의를 완료합니다. 그런 다음 프로세스를 중지합니다.

6. 호스트를 node /path/to/google-slides-mcp/build/index.js로 지정합니다. 환경 변수를 설정하지 마세요.

호스트 구성 예시:

"google-slides-mcp": {
  "transportType": "stdio",
  "command": "node",
  "args": [
    "/path/to/google-slides-mcp/build/index.js"
  ]
}

경로를 본인 컴퓨터의 컴파일된 build/index.js로 바꾸세요.

첫 번째 시작

프로세스가 루프백 페이지를 엽니다.

• 저장소에 클라이언트 ID 또는 클라이언트 시크릿이 없으면 두 값을 붙여넣습니다.

• Google 동의 화면으로 계속 진행합니다.

• 성공 페이지를 닫습니다.

프로세스는 Google 자격 증명을 토큰 저장소에 기록합니다. 먼저 OS 키체인을 시도합니다. 키체인을 사용할 수 없으면 ~/.config/google-slides-mcp/credential.json을 사용합니다. 파일 모드는 0600입니다.

이후 시작 시에는 저장소를 사용합니다. 브라우저가 열리지 않습니다.

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN은 각각 하나의 필드를 재정의할 수 있습니다. 필수는 아닙니다. 환경 변수가 누락된 필드를 제공하면 프로세스는 병합된 자격 증명을 저장소에 기록합니다.

호스트 없이 실행

npm run start

프로세스는 stdio에서 수신 대기합니다. Stderr에 Google Slides MCP server running and connected via stdio.가 출력됩니다.

사용 가능한 도구

• create_presentation: 새 Google Slides 프레젠테이션을 만듭니다.

  • 입력:

    • title (string, required): 새 프레젠테이션의 제목입니다.

  • 출력: 생성된 프레젠테이션 세부 정보를 나타내는 JSON 객체입니다.

• get_presentation: 기존 프레젠테이션에 대한 세부 정보를 검색합니다.

  • 입력:

    • presentationId (string, required): 검색할 프레젠테이션의 ID입니다.

    • fields (string, optional): 반환되는 데이터를 제한하는 필드 마스크(예: "slides,pageSize")입니다.

  • 출력: 프레젠테이션 세부 정보를 나타내는 JSON 객체입니다.

• batch_update_presentation: 프레젠테이션에 일련의 업데이트를 적용합니다. 슬라이드를 수정하는 기본 방법입니다(텍스트, 도형, 이미지 추가, 슬라이드 만들기 등).

  • 입력:

    • presentationId (string, required): 업데이트할 프레젠테이션의 ID입니다.

    • requests (array, required): 업데이트를 정의하는 요청 객체 배열입니다. 개별 요청의 구조는 Google Slides API batchUpdate 문서를 참조하세요.

    • writeControl (object, optional): 쓰기 요청 실행을 제어합니다(예: 개정 ID 사용).

  • 출력: 일괄 업데이트 결과를 나타내는 JSON 객체입니다.

• get_page: 프레젠테이션 내 특정 페이지(슬라이드)에 대한 세부 정보를 검색합니다.

  • 입력:

    • presentationId (string, required): 검색할 프레젠테이션의 ID입니다.

    • pageObjectId (string, required): 검색할 페이지(슬라이드)의 객체 ID입니다.

  • 출력: 페이지 세부 정보를 나타내는 JSON 객체입니다.

• summarize_presentation: 요약을 더 쉽게 하기 위해 프레젠테이션에서 모든 텍스트 콘텐츠를 추출하고 형식을 지정합니다.

  • 입력:

    • presentationId (string, required): 요약할 프레젠테이션의 ID입니다.

    • include_notes (boolean, optional): 요약에 발표자 노트를 포함할지 여부입니다. 기본값은 false입니다.

  • 출력: 다음을 포함하는 JSON 객체:

    • title: 프레젠테이션의 제목

    • slideCount: 전체 슬라이드 수

    • lastModified: 개정 정보

    • slides: 다음을 포함하는 슬라이드 객체 배열:

      • slideNumber: 프레젠테이션 내 위치

      • slideId: 슬라이드의 객체 ID

      • content: 슬라이드에서 추출된 모든 텍스트

      • notes: 발표자 노트(요청했고 사용 가능한 경우)