MCP Google Docs

🚀 MCP 谷歌工作區集成

MCP（元界控制協議）是一款全面的工具，可與谷歌工作區的各類服務進行交互，如 Google Docs、表格、幻燈片和雲端硬盤等，為用戶提供便捷高效的操作體驗。

🚀 快速開始

運行程序

python main.py

通過 MCP 使用工具

谷歌雲端硬盤示例

# 列出文件
mcp list_files

# 複製文件
mcp copy_file --file-id "file_id" --new_name "new_name"

谷歌表格示例

# 獲取工作表數據
mcp get_sheet_data --spreadsheet_id "your_spreadsheet_id" --range "Sheet1!A1:D10"

# 創建圖表
mcp create_chart --chart_type "LINE" --range "A1:B10" --sheet_name "Sheet1" --title "Sales Trend"

谷歌文檔示例

# 創建文檔
mcp create_document --title "My Document"

# 向文檔插入帶格式的文本
mcp insert_text_to_document --document_id "doc_id" --text "Hello World" --font_family "Arial" --font_size 12

谷歌幻燈片示例

# 創建演示文稿
mcp create_presentation --title "My Presentation"

# 向演示文稿添加包含內容的幻燈片
mcp add_slide_to_presentation --presentation_id "presentation_id" --title "Slide Title" --content "Slide Content"

✨ 主要特性

谷歌雲端硬盤功能

• 列出文件
• 複製文件
• 重命名文件
• 創建空白電子表格
• 使用模板創建電子表格
• 複製現有電子表格

谷歌表格功能

• 列出工作表
• 複製工作表
• 重命名工作表
• 獲取工作表數據
• 添加/刪除行
• 添加/刪除列
• 更新單元格
• 創建/更新/刪除圖表
• 更新單元格格式

谷歌文檔功能

• 創建文檔
• 插入帶格式的文本
• 添加標題
• 插入圖像
• 創建和管理表格
• 插入頁眉
• 添加水平分隔線
• 更新文檔樣式
• 管理表格樣式和內容

谷歌幻燈片功能

• 創建演示文稿
• 添加幻燈片
• 插入圖像
• 添加形狀和線條
• 更新文本樣式
• 修改幻燈片背景
• 更新幻燈片佈局
• 添加幻燈片切換
• 添加演講者備註

📦 安裝指南

1. 虛擬環境設置

macOS/Linux

# 創建虛擬環境
python -m venv venv

# 激活虛擬環境
source venv/bin/activate

Windows

# 創建虛擬環境
python -m venv venv

# 激活虛擬環境
venv\Scripts\activate

2. 安裝所需包

pip install -r requirements.txt

3. 谷歌雲控制檯設置

1. 在谷歌雲控制檯創建項目
2. 創建 OAuth 2.0 客戶端 ID
3. 啟用所需的 API：
   • 谷歌表格 API
   • 谷歌雲端硬盤 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"  # 可選

📚 詳細文檔

環境變量

📄 許可證

MIT License