Google Sheets MCP Server

Google Sheets MCP 服务

一个使用 Go 编写的 Google Sheets 模型上下文协议（MCP）服务。提供与 Google Spreadsheets 交互的全面工具。

功能

• 工作表数据：获取/更新单元格数据和公式，执行批量操作
• 工作表管理：创建、重命名、复制工作表，添加行/列
• 电子表格管理：创建、列出和共享电子表格
• 多种身份验证方式：服务账号、OAuth2、ADC

快速开始

1. 构建：

   make build
   

2. 设置 Google API 凭据（详细说明请参阅 SETUP.md）

3. 配置环境：

   # Service Account (recommended)
   export SERVICE_ACCOUNT_PATH="path/to/service-account.json"
   
   # OAuth2
   export CREDENTIALS_PATH="path/to/credentials.json"
   
   # Base64 encoded service account
   export CREDENTIALS_CONFIG="base64_encoded_service_account_json"
   

4. 运行：

   # Stdio mode
   ./go_mcp_server_google_sheets
   
   # SSE mode
   ./go_mcp_server_google_sheets -t sse -p 8891
   

环境变量

• SERVICE_ACCOUNT_PATH - 服务账号 JSON 文件的路径
• CREDENTIALS_PATH - OAuth2 凭据 JSON 文件的路径
• CREDENTIALS_CONFIG - 经 Base64 编码的服务账号 JSON
• TOKEN_PATH - OAuth2 令牌存储路径（默认值：token.json）
• DRIVE_FOLDER_ID - 用于存放新电子表格的 Google Drive 文件夹 ID

可用工具

数据操作

• get_sheet_data - 获取工作表中的数据
• get_sheet_formulas - 获取工作表中的公式
• update_cells - 更新单元格值
• batch_update_cells - 批量更新多个范围

工作表管理

• list_sheets - 列出电子表格中的所有工作表
• create_sheet - 创建新工作表
• rename_sheet - 重命名现有工作表
• copy_sheet - 在电子表格之间复制工作表
• add_rows / add_columns - 添加行或列

电子表格管理

• create_spreadsheet - 创建新电子表格
• list_spreadsheets - 列出 Drive 中的电子表格
• share_spreadsheet - 与用户共享电子表格

身份验证设置

方法 1：服务账号（推荐）

1. 创建 Google Cloud 项目：

   • 前往 Google Cloud 控制台
   • 创建新项目或选择现有项目

2. 启用 API：

   • 前往“API 和服务”>“库”
   • 启用“Google Sheets API”
   • 启用“Google Drive API”

3. 创建服务账号：

   • 前往“API 和服务”>“凭据”
   • 点击“创建凭据”>“服务账号”
   • 填写服务账号详细信息
   • 点击“创建并继续”

4. 生成密钥：

   • 点击创建的服务账号
   • 前往“密钥”标签页
   • 点击“添加密钥”>“创建新密钥”
   • 选择“JSON”格式
   • 下载文件（这就是你的 service-account.json）

5. 设置环境变量：

   export SERVICE_ACCOUNT_PATH="/path/to/your/service-account.json"
   

方法 2：OAuth2（用于用户访问）

1. 创建 OAuth2 凭据：

   • 在 Google Cloud 控制台中，前往“API 和服务”>“凭据”
   • 点击“创建凭据”>“OAuth 客户端 ID”
   • 选择“桌面应用”
   • 下载 JSON 文件（这就是你的 credentials.json）

2. 设置环境变量：

   export CREDENTIALS_PATH="/path/to/your/credentials.json"
   

方法 3：Base64 编码（用于容器/CI）

1. 对服务账号进行编码：

   base64 -w 0 /path/to/service-account.json
   

2. 设置环境变量：

   export CREDENTIALS_CONFIG="your_base64_encoded_string_here"
   

与服务账号共享电子表格

使用服务账号时，需要与服务账号电子邮件地址共享电子表格：

1. 打开 Google Spreadsheet
2. 点击“共享”按钮
3. 添加服务账号电子邮件地址（可在 JSON 文件的 client_email 中找到）
4. 授予相应权限（查看者/编辑者）

许可证

MIT