Google Workspace集成工具

一个全面的MCP工具,用于与Google Workspace服务(包括Google Docs、Sheets、Slides和Drive)进行交互,提供文件管理、文档编辑、表格处理和幻灯片制作等功能。

  • by dev-ithitchhiker
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 dev-ithitchhiker/mcp-google-docs

使用说明

MCP谷歌工作区集成

一个全面的MCP(Metoro控制协议)工具,用于与谷歌工作区服务(包括谷歌文档、表格、幻灯片和驱动器)进行交互。

特性

谷歌云端硬盘功能

  • 列出文件
  • 复制文件
  • 重新命名
  • 创建空电子表格
  • 从模板创建电子表格
  • 复制现有电子表格

谷歌表格功能

  • 列表表
  • 复制工作表
  • 重命名图纸
  • 获取工作表数据
  • 添加/删除行
  • 添加/删除列
  • 更新单元格
  • 创建/更新/删除图表
  • 更新单元格格式

谷歌文档功能

  • 创建文档
  • 插入带格式的文本
  • 添加标题
  • 插入图像
  • 创建和管理表
  • 插入分页符
  • 添加横向规则
  • 更新文档样式
  • 管理表格样式和内容

谷歌幻灯片功能

  • 创建演示文稿
  • 添加幻灯片
  • 插入图像
  • 添加形状和线条
  • 更新文本样式
  • 修改幻灯片背景
  • 更新幻灯片布局
  • 添加幻灯片过渡
  • 添加演讲者备注

安装

1.虚拟环境设置

macOS/Linux

# Create virtual environment
python -m venv venv

# Activate virtual environment
source venv/bin/activate

视窗

# Create virtual environment
python -m venv venv

# Activate virtual environment
venv\Scripts\activate

2.安装所需的软件包

pip install -r requirements.txt

3.谷歌云控制台设置

  1. 在Google Cloud Console中创建项目
  2. 创建OAuth 2.0客户端ID
  3. 启用所需的API:
    • 谷歌网页API
    • Google Drive API
    • 谷歌文档API
    • 谷歌幻灯片API

4.环境变量设置

export MCPGD_CLIENT_SECRET_PATH="/path/to/client_secret.json"
export MCPGD_FOLDER_ID="your_folder_id"
export MCPGD_TOKEN_PATH="/path/to/token.json"  # Optional

用法

1.运行程序

python main.py

2.通过MCP使用工具

Google Drive示例

# List files
mcp list_files

# Copy a file
mcp copy_file --file-id "file_id" --new_name "new_name"

谷歌表格示例

# Get sheet data
mcp get_sheet_data --spreadsheet_id "your_spreadsheet_id" --range "Sheet1!A1:D10"

# Create chart
mcp create_chart --chart_type "LINE" --range "A1:B10" --sheet_name "Sheet1" --title "Sales Trend"

谷歌文档示例

# Create document
mcp create_document --title "My Document"

# Insert formatted text
mcp insert_text_to_document --document_id "doc_id" --text "Hello World" --font_family "Arial" --font_size 12

谷歌幻灯片示例

# Create presentation
mcp create_presentation --title "My Presentation"

# Add slide with content
mcp add_slide_to_presentation --presentation_id "presentation_id" --title "Slide Title" --content "Slide Content"

环境变量

  • MCPGD_CLIENT_SECRET_PATH:Google OAuth 2.0客户端机密文件的路径
  • MCPGD_FOLDER_ID:Google Drive文件夹ID
  • MCPGD_TOKEN_PATH:令牌存储文件的路径(可选,默认:~/.mcp_google_spreadsheet.json)

许可证

MIT许可证