gws-mcp-server

MCP-сервер, который предоставляет операции Google Workspace CLI (gws) в качестве инструментов Model Context Protocol.

Зачем?

В CLI gws был встроенный MCP-сервер, который был удален в версии 0.8.0, так как он предоставлял 200-400 инструментов, что приводило к переполнению контекстного окна в MCP-клиентах. Этот сервер использует избирательный подход: вы выбираете, какие сервисы Google предоставить, и только сфокусированный набор высокоценных операций с узкой областью применения регистрируется в качестве инструментов.

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

• Node.js 18+

• Установленный и авторизованный CLI gws (npm install -g @googleworkspace/cli && gws auth login)

Быстрый старт

# Install
npm install -g gws-mcp-server

# Or run from source
git clone https://github.com/conorbronsdon/gws-mcp-server.git
cd gws-mcp-server
npm install && npm run build

Конфигурация

Claude Code (.mcp.json)

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": [
        "gws-mcp-server",
        "--services", "drive,sheets,calendar,docs,gmail"
      ]
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": [
        "gws-mcp-server",
        "--services", "drive,sheets,calendar"
      ]
    }
  }
}

Опции

Доступные сервисы и инструменты

drive (8 инструментов)

• drive_files_list — Поиск и список файлов

• drive_files_get — Получение метаданных файла

• drive_files_create — Создание файлов (с опциональной загрузкой)

• drive_files_copy — Копирование файлов (полезно для конвертации форматов)

• drive_files_update — Обновление метаданных/содержимого файла

• drive_files_delete — Удаление файлов

• drive_files_export — Экспорт файлов Google Workspace (Doc, Sheet, Slide) в другие форматы

• drive_permissions_create — Предоставление доступа к файлам

sheets (4 инструмента)

• sheets_get — Получение метаданных электронной таблицы

• sheets_values_get — Чтение значений ячеек

• sheets_values_update — Запись значений ячеек

• sheets_values_append — Добавление строк

calendar (5 инструментов)

• calendar_events_list — Список событий

• calendar_events_get — Получение деталей события

• calendar_events_insert — Создание событий

• calendar_events_update — Обновление событий

• calendar_events_delete — Удаление событий

docs (3 инструмента)

• docs_get — Получение содержимого документа

• docs_create — Создание документов

• docs_batchUpdate — Применение обновлений к документу

gmail (4 инструмента)

• gmail_messages_list — Поиск сообщений

• gmail_messages_get — Чтение сообщения

• gmail_threads_list — Поиск цепочек писем

• gmail_threads_get — Чтение полной цепочки писем

Всего: 24 инструмента (против 200-400 в старой реализации)

Добавление новых инструментов

Отредактируйте src/services.ts для добавления определений инструментов. Каждый инструмент напрямую сопоставляется с командой CLI gws:

{
  name: "drive_files_list",           // MCP tool name
  description: "List files in Drive", // Shown to AI
  command: ["drive", "files", "list"],// gws CLI args
  params: [                           // Maps to --params JSON
    { name: "q", description: "Search query", type: "string", required: false },
  ],
  bodyParams: [                       // Maps to --json body
    { name: "name", description: "File name", type: "string", required: true },
  ],
}

Архитектура

MCP Client (Claude) ←→ stdio ←→ gws-mcp-server ←→ gws CLI ←→ Google APIs

Сервер представляет собой тонкую обертку: он преобразует вызовы инструментов MCP в вызовы CLI gws, передает --params и --json по мере необходимости и возвращает вывод в формате JSON.

Отказ от ответственности

Все взгляды, мнения и утверждения, выраженные в этом аккаунте, являются исключительно моими собственными и сделаны в личном качестве. Они не отражают и не должны толковаться как отражающие взгляды, позиции или политику Modular. Этот аккаунт не связан с Modular, не авторизован и не одобрен компанией Modular каким-либо образом.

Лицензия

MIT