Сервер MCP Google Docs

Это сервер Model Context Protocol (MCP), который позволяет вам подключаться к Google Docs через Claude. С этим сервером вы можете:

Перечислите все документы Google на вашем Диске
Прочитайте содержание конкретных документов
Создать новые документы
Обновить существующие документы
Поиск документов
Удалить документы

Предпосылки

Node.js v16.0.0 или более поздняя версия
Проект Google Cloud с включенными API Google Docs и API Google Drive
Учетные данные OAuth 2.0 для вашего проекта Google Cloud

Настраивать

Клонируйте этот репозиторий и перейдите в каталог проекта:

git clone https://github.com/yourusername/MCP-Google-Doc.git
cd MCP-Google-Doc

Установить зависимости:

npm install

Создайте идентификатор клиента OAuth 2.0 в Google Cloud Console:
- Перейдите в Google Cloud Console.
- Создайте новый проект или выберите существующий
- Включите API Google Docs и API Google Drive
- Перейдите в раздел «API и службы» > «Учетные данные».
- Нажмите «Создать учетные данные» > «Идентификатор клиента OAuth».
- Выберите «Приложение для настольного компьютера» в качестве типа приложения.
- Загрузите файл JSON и сохраните его как credentials.json в каталоге вашего проекта.
Важно : Файлы credentials.json и token.json содержат конфиденциальную информацию и исключаются из контроля версий через .gitignore . Никогда не фиксируйте эти файлы в своем репозитории.
Создайте проект:

npm run build

Запустите сервер:

npm start

При первом запуске сервера вам будет предложено пройти аутентификацию в Google. Следуйте инструкциям на экране, чтобы авторизовать приложение. Это сгенерирует файл token.json , в котором будут храниться ваши токены доступа.

Соображения безопасности

Credential Security : и credentials.json , и token.json содержат конфиденциальную информацию и никогда не должны передаваться или передаваться в систему контроля версий. Они уже добавлены в файл .gitignore .
Обновление токена : приложение автоматически обновляет токен доступа по истечении срока его действия.
Отзыв доступа : если вам необходимо отозвать доступ, удалите файл token.json и перейдите в настройки безопасности своего аккаунта Google, чтобы удалить приложение из списка авторизованных приложений.

Подключение к Claude для рабочего стола

Чтобы использовать этот сервер с Claude for Desktop:

Отредактируйте файл конфигурации Claude Desktop:
- В macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- В Windows: %APPDATA%\Claude\claude_desktop_config.json
Добавьте в вашу конфигурацию следующее:

{
  "mcpServers": {
    "googledocs": {
      "command": "node",
      "args": ["/absolute/path/to/build/server.js"]
    }
  }
}

Замените /absolute/path/to/build/server.js на фактический путь к вашему собранному файлу server.js.

Перезапустите Claude для рабочего стола.

Пользовательский интерфейс

Сервер Google Docs MCP имеет удобный диалоговый интерфейс, который:

Представляет информацию документа в понятном, удобном для чтения формате.
Использует ответы на естественном языке, а не необработанные данные API
Форматирует даты в удобном для восприятия человеком виде.
Предоставляет полезные контрольные вопросы после действий
Никогда не раскрывает конфиденциальные данные, такие как токены OAuth

Этот стиль интерфейса разработан с учетом других интеграций Claude MCP, таких как Notion, обеспечивая единообразный и приятный пользовательский интерфейс.

Разработка

Структура проекта

google-docs-integration/
├── build/                # Compiled JavaScript files
├── src/                  # TypeScript source code
│   └── server.ts         # Main server implementation
├── .gitignore            # Git ignore file
├── credentials.json      # OAuth 2.0 credentials (not in version control)
├── package.json          # Project dependencies and scripts
├── README.md             # Project documentation
├── token.json            # OAuth tokens (not in version control)
└── tsconfig.json         # TypeScript configuration

Добавление новых функций

Чтобы добавить новые функции на сервер MCP:

Измените файл src/server.ts для реализации новых функций.
Соберите проект с помощью npm run build
Проверьте свои изменения, запустив npm start

Доступные ресурсы

googledocs://list — список всех документов Google на вашем Диске.
googledocs://{docId} — получает содержимое определенного документа по идентификатору

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

create-doc — создает новый документ Google с указанным заголовком и дополнительным содержимым.
update-doc — обновляет существующий документ Google новым содержимым (добавление или замена)
insert-text — вставляет текст непосредственно в документ без Notion или других интеграций.
search-docs — Поиск документов Google, содержащих определенный текст.
delete-doc — удаляет документ Google по идентификатору

Доступные подсказки

create-doc-template — помогает создать новый документ на основе указанной темы и стиля написания.
analyze-doc — анализирует содержимое документа и предоставляет сводку

Примеры использования

Вот несколько примеров подсказок, которые вы можете использовать с Клодом после подключения к серверу:

«Покажи мне список всех моих Google Docs»
«Создайте новый документ Google под названием «Заметки о встрече» с содержимым «Темы для обсуждения: ...»»
«Обновить мой документ с идентификатором «1abc123def456», добавив в конец этот раздел: ...»
«Поиск в моих Google Docs любых документов, содержащих «предложение проекта»»
«Удалить документ Google с идентификатором '1abc123def456'»
«Создать официальный документ об изменении климата»
«Проанализируйте содержимое документа с идентификатором '1abc123def456'»

Поиск неисправностей

Если у вас возникли проблемы с аутентификацией:

Удалите файл token.json в каталоге вашего проекта.
Запустите сервер еще раз, чтобы запустить новый поток аутентификации.

Если у вас возникли проблемы с API Google Docs:

Убедитесь, что API включен в вашей Google Cloud Console.
Проверьте, что ваши учетные данные OAuth имеют правильные области действия.

Внося вклад

Форк репозитория
Создайте ветку функции: git checkout -b feature/your-feature-name
Зафиксируйте изменения: git commit -am 'Add some feature'
Отправка в ветку: git push origin feature/your-feature-name
Отправить запрос на извлечение

Лицензия

Массачусетский технологический институт

Переменные среды

Создайте файл .env в корне проекта (или экспортируйте переменные в оболочку) со следующими ключами:

# OAuth 2.0 client credentials – **JSON string** of the credentials file
GOOGLE_DOCS_CREDENTIALS_JSON={...}

# OAuth token – **JSON string** returned by the OAuth consent flow
GOOGLE_DOCS_TOKEN_JSON={...}

Если эти переменные установлены, сервер не будет пытаться прочитать credentials.json или token.json с диска.

Google Docs MCP Server

Integrations