MCP Google Spreadsheet

基本能力

产品定位

mcp-google-docs 是一个用于操作 Google Spreadsheet 和 Google Drive 的工具，基于 MCP (Metoro Control Protocol) 实现。

核心功能

Google Drive 功能

• 文件列表查询
• 文件复制
• 文件重命名
• 创建空白表格
• 基于模板创建表格
• 复制现有表格

Google Sheets 功能

• 表格列表查询
• 表格复制
• 表格重命名
• 表格数据查询
• 行/列添加/删除
• 单元格更新
• 图表创建/修改/删除
• 单元格格式修改

适用场景

• 自动化处理 Google 表格数据
• 批量管理 Google Drive 文件
• 基于模板生成报表
• 数据可视化（图表生成）

工具列表

• mcp list_files: 查询文件列表
• mcp get_sheet_data: 获取表格数据
• mcp create_chart: 创建图表

常见问题解答

1. 需要先在 Google Cloud Console 创建项目并启用相关 API
2. 需要配置 OAuth 2.0 客户端 ID
3. 需要设置环境变量指定客户端密钥文件路径

使用教程

使用依赖

1. Python 环境
2. Google Cloud Console 项目
3. 启用的 API: Google Sheets API 和 Google Drive API

安装教程

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. Google Cloud Console 设置

1. 创建项目
2. 创建 OAuth 2.0 客户端 ID
3. 启用 Google Sheets API 和 Google Drive 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"

调试方式

# 运行主程序
python main.py

# 测试文件列表查询
mcp list_files

# 测试获取表格数据
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"

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。