表格交互协议

Google Sheets MCP是一个允许AI代理直接与电子表格交互的模型上下文协议连接器,适用于自动化数据处理和表格管理场景。

  • by mkummer225
  • JavaScript
  • 本地部署
  • 138 星标
  • 更新于
在 GitHub 查看 mkummer225/google-sheets-mcp

使用说明

谷歌表格MCP

Google表格的模型上下文协议(MCP)连接器,允许AI代理直接与电子表格交互。

演示

https://github.com/user-attachments/assets/cc4729d9-4e6e-437b-848b-6da9a09418c3

设置

  1. 克隆此存储库:
git clone https://github.com/mkummer225/google-sheets-mcp
cd google-sheets-mcp
  1. 安装依赖项: npm install

  2. 构建: npm run build

  3. 在Google Cloud Platform中创建OAuth凭据:

    • 在中创建新项目 谷歌云控制台
    • 启用 谷歌网页API
    • 配置OAuth同意屏幕
    • 使用适当的重定向URI创建OAuth客户端ID凭据(桌面应用程序)(例如:http://localhost:3000/oauth2callback)
    • 下载凭据并另存为 gcp-oauth.keys.json 在 dist 子目录
  4. 启动MCP服务器(必要时会自动提示您验证/重新验证您的Google帐户): npm run start

用法

示例配置:

{
    "mcpServers": {
    "google-sheets-mcp": {
      "command": "node",
      "args": [
        "/{path_to_dir}/google-sheets-mcp/dist/index.js"
      ]
    }
  }
}

然后,您应该能够简单地指定您的电子表格ID,或者让您的代理为您创建一个新的电子表格。

可用操作

动作 描述
refresh_auth 凭据过期时重新验证您的Google帐户
list_sheets 列出Google电子表格中的所有工作表/选项卡
create_sheet 在Google电子表格中创建新的表格/选项卡
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电子表格

许可证

麻省理工学院