AI导哈

Google Sheets MCP连接器

Google Sheets MCP连接器允许AI代理直接与电子表格交互，适用于自动化数据处理和管理场景。

  • by RoelofvHeeren
  • JavaScript
  • 混合部署
  • 更新于
在 GitHub 查看 RoelofvHeeren/Final-Sheet-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

托管/铁路（SSE运输）

如果您需要基于URL的MCP端点（例如，对于Agent Toolkit的“连接到MCP服务器”流），请使用SSE传输运行并部署到Railway等主机：

  1. 构建： npm run build
  2. 设置环境变量（不提交机密）：
    • MCP_TRANSPORT=sse
    • PORT=3000 （或您平台的端口）
    • GSHEETS_OAUTH_JSON --您的OAuth客户端JSON（纯文本或base64编码）。如果文件 dist/gcp-oauth.keys.json 不存在。
    • GSHEETS_CREDENTIALS_JSON --预授权的JSON证书（纯或base64编码）。使用此选项可避免在托管环境中进行交互式身份验证。
  3. 部署 dist/ 到铁路和运行 node dist/index.js.
  4. 在客户端/UI中，将MCP URL指向 https://<your-railway-app>.up.railway.app/sse （服务器将把POST定向到 /messages 通过SSE端点事件）。

注：保留 *.keys.json 以及git中的凭据文件。请改用env变量或主机的机密管理器。

用法

示例配置：

{
    "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电子表格

许可证

麻省理工学院

相关 MCP