JinDaGe - mcp-google-docs MCP Details

article

README

🚀 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. 谷歌云控制台设置

在谷歌云控制台创建项目
创建 OAuth 2.0 客户端 ID
启用所需的 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"  # 可选

📚 详细文档

环境变量

| 属性 | 详情 | |------|------| | MCPGD_CLIENT_SECRET_PATH | 谷歌 OAuth 2.0 客户端密钥文件路径 | | MCPGD_FOLDER_ID | 谷歌云端硬盘文件夹 ID | | MCPGD_TOKEN_PATH | 令牌存储文件路径（可选，默认：~/.mcp_google_spreadsheet.json） |

📄 许可证

MIT License

mcp-google-docs