基本能力
产品定位
Google Sheets MCP 是一个专门用于与 Google Sheets 交互的 MCP 连接器,旨在为 AI 代理提供直接操作电子表格的能力。
核心功能
- 数据读取:支持读取表格中的所有数据、特定行、列或标题。
- 数据编辑:支持编辑单个单元格、整行或整列数据。
- 表格管理:支持创建新的表格、重命名表格或工作表、插入行或列等。
- 认证管理:支持重新认证 Google 账户。
适用场景
- 自动化数据处理:AI 代理可以自动读取和更新 Google Sheets 中的数据。
- 协作工具集成:在团队协作中,AI 可以管理共享的电子表格。
- 开发效率提升:开发者可以通过 AI 代理快速操作表格数据,减少手动操作。
工具列表
- refresh_auth:重新认证 Google 账户。
- list_sheets:列出所有工作表。
- create_sheet:创建新的工作表。
- create_spreadsheet:创建新的电子表格。
- read_all_from_sheet:读取工作表中的所有数据。
- read_headings:读取列标题。
- read_rows:读取特定行。
- read_columns:读取特定列。
- edit_cell:编辑单个单元格。
- edit_row:编辑整行。
- edit_column:编辑整列。
- insert_row:插入新行。
- insert_column:插入新列。
- rename_sheet:重命名工作表。
- rename_doc:重命名电子表格。
常见问题解答
- 如何认证 Google 账户?:在启动 MCP 服务器时,系统会自动提示认证。
- 如何创建新的电子表格?:使用
create_spreadsheet
操作。 - 如何读取特定行或列?:使用
read_rows
或read_columns
操作。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
- 克隆仓库并安装依赖:
bash
git clone https://github.com/mkummer225/google-sheets-mcp
cd google-sheets-mcp
npm install
安装教程
- 构建项目:
bash
npm run build - 在 Google Cloud Platform 创建 OAuth 凭证:
- 创建新项目并启用 Google Sheets API。
- 配置 OAuth 同意屏幕并创建客户端 ID(桌面应用)。
- 下载凭证并保存为
gcp-oauth.keys.json
到dist
目录。 - 启动 MCP 服务器:
bash
npm run start
调试方式
- 启动服务器后,系统会提示认证 Google 账户。
- 使用提供的操作(如
list_sheets
)测试连接和功能。 - 检查日志输出以排查问题。