Сервер 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

Related MCP server: Ultimate Google Docs & Drive MCP Server

Настраивать

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

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

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

npm install

3. Создайте идентификатор клиента 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 . Никогда не фиксируйте эти файлы в своем репозитории.

4. Создайте проект:

npm run build

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

npm start

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

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

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

• Обновление токена : приложение автоматически обновляет токен доступа по истечении срока его действия.

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

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

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

1. Отредактируйте файл конфигурации Claude Desktop:

   • В macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • В Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Добавьте в вашу конфигурацию следующее:

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

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

3. Перезапустите 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:

1. Измените файл src/server.ts для реализации новых функций.

2. Соберите проект с помощью npm run build

3. Проверьте свои изменения, запустив 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'»

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

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

1. Удалите файл token.json в каталоге вашего проекта.

2. Запустите сервер еще раз, чтобы запустить новый поток аутентификации.

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

1. Убедитесь, что API включен в вашей Google Cloud Console.

2. Проверьте, что ваши учетные данные OAuth имеют правильные области действия.

Внося вклад

1. Форк репозитория

2. Создайте ветку функции: git checkout -b feature/your-feature-name

3. Зафиксируйте изменения: git commit -am 'Add some feature'

4. Отправка в ветку: git push origin feature/your-feature-name

5. Отправить запрос на извлечение

Лицензия

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

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

Создайте файл .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 с диска.