Google Slides MCP Server

Этот процесс является MCP-сервером для Google Slides API. Хост общается с ним через stdio. При первом запуске открывается браузер. Вы вставляете идентификатор клиента и секрет клиента Desktop. Затем следует согласие Google. При последующих запусках считывается хранилище токенов.

Предварительные требования

• Node.js 20 или новее

• Проект Google Cloud с включённым Google Slides API

• Идентификатор клиента и секрет клиента OAuth Desktop

Вам не нужен refresh-токен. Вам не нужны переменные окружения процесса.

Related MCP server: Google Slides MCP Server

Claude Code

1. Создайте OAuth-клиент Desktop. Воспользуйтесь шагами платформы Google Auth ниже.

2. В Claude Code выполните:

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

3. Выполните /reload-plugins, если Claude попросит.

4. При первом запуске откроется браузер. Вставьте идентификатор клиента и секрет клиента. Завершите согласие Google.

Последующие сеансы считывают хранилище токенов. Никакого host JSON. Никаких переменных окружения.

Другие хосты

1. Клонируйте этот репозиторий.

2. Выполните npm install.

3. Выполните npm run build.

4. Создайте OAuth-клиент Desktop в Google Cloud Console:

   • Откройте платформу Google Auth.

   • Если страница сообщает, что платформа не настроена, нажмите Get Started.

   • Имя приложения: Google Slides MCP. Адрес электронной почты поддержки пользователей: ваш адрес.

   • Аудитория: External.

   • Контактный адрес электронной почты: ваш адрес. Согласитесь с политикой. Нажмите Create.

   • Откройте Audience. Добавьте свой Gmail как тестового пользователя.

   • Откройте Data Access. Добавьте https://www.googleapis.com/auth/presentations и https://www.googleapis.com/auth/drive.readonly. Сохраните.

   • Откройте Clients. Нажмите Create Client. Тип приложения: Desktop app. Имя: Google Slides MCP Desktop. Нажмите Create.

   • Скопируйте идентификатор клиента и секрет клиента.

5. Выполните npm run start. Вставьте идентификатор клиента и секрет клиента. Завершите согласие 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 на вашей машине.

Первый запуск

Процесс открывает страницу loopback.

• Если в хранилище нет идентификатора клиента или секрета клиента, вставьте эти два значения.

• Перейдите к согласию Google.

• Закройте страницу успеха.

Процесс записывает учётные данные Google в хранилище токенов. Сначала он пробует связку ключей ОС. Если связка ключей недоступна, используется ~/.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, обязательный): Название новой презентации.

  • Выходные данные: JSON-объект с деталями созданной презентации.

• get_presentation: Получает сведения о существующей презентации.

  • Входные данные:

    • presentationId (string, обязательный): Идентификатор презентации для получения.

    • fields (string, необязательный): Маска полей (например, "slides,pageSize") для ограничения возвращаемых данных.

  • Выходные данные: JSON-объект с деталями презентации.

• batch_update_presentation: Применяет серию обновлений к презентации. Это основной метод изменения слайдов (добавление текста, фигур, изображений, создание слайдов и т. д.).

  • Входные данные:

    • presentationId (string, обязательный): Идентификатор презентации для обновления.

    • requests (array, обязательный): Массив объектов запросов, определяющих обновления. Обратитесь к документации batchUpdate Google Slides API за структурой отдельных запросов.

    • writeControl (object, необязательный): Управляет выполнением запросов на запись (например, с использованием идентификаторов ревизий).

  • Выходные данные: JSON-объект с результатом пакетного обновления.

• get_page: Получает сведения о конкретной странице (слайде) внутри презентации.

  • Входные данные:

    • presentationId (string, обязательный): Идентификатор презентации для получения.

    • pageObjectId (string, обязательный): Идентификатор объекта страницы (слайда) для получения.

  • Выходные данные: JSON-объект с деталями страницы.

• summarize_presentation: Извлекает и форматирует весь текстовый контент презентации для упрощённого обобщения.

  • Входные данные:

    • presentationId (string, обязательный): Идентификатор презентации для обобщения.

    • include_notes (boolean, необязательный): Включать ли заметки докладчика в сводку. По умолчанию false.

  • Выходные данные: JSON-объект, содержащий:

    • title: Название презентации

    • slideCount: Общее количество слайдов

    • lastModified: Информация о ревизии

    • slides: Массив объектов слайдов, содержащих:

      • slideNumber: Позиция в презентации

      • slideId: Идентификатор объекта слайда

      • content: Весь текст, извлечённый со слайда

      • notes: Заметки докладчика (если запрошены и доступны)