MCP Google Workspace Integration

MCP Google Workspace 集成

用于与 Google Workspace 服务交互的综合 MCP（Metoro Control Protocol）工具，包括 Google Docs、Sheets、Slides 和 Drive。

功能

Google Drive 功能

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

Google Sheets 功能

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

Google Docs 功能

• 创建文档
• 插入带格式的文本
• 添加标题
• 插入图片
• 创建和管理表格
• 插入分页符
• 添加水平线
• 更新文档样式
• 管理表格样式和内容

Google Slides 功能

• 创建演示文稿
• 添加幻灯片
• 插入图片
• 添加形状和线条
• 更新文本样式
• 修改幻灯片背景
• 更新幻灯片版式
• 添加幻灯片转场效果
• 添加演讲者备注

安装

1. 设置虚拟环境

macOS/Linux

# Create virtual environment
python -m venv venv

# Activate virtual environment
source venv/bin/activate

Windows

# Create virtual environment
python -m venv venv

# Activate virtual environment
venv\Scripts\activate

2. 安装所需软件包

pip install -r requirements.txt

3. 设置 Google Cloud Console

1. 在 Google Cloud Console 中创建项目
2. 创建 OAuth 2.0 客户端 ID
3. 启用所需 API：
   • Google Sheets API
   • Google Drive API
   • Google Docs API
   • Google Slides 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"

Google Sheets 示例

# 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"

Google Docs 示例

# 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

Google Slides 示例

# 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 许可证