STARWARCLOUD STARWAR.AI
返回市场
谷歌表格MCP

谷歌表格MCP

作者：henilcalagiya12 星标更新：2025-09-11
安装使用来源：spider==github.com

项目介绍

Google Sheets MCP Server

使用模型上下文协议（MCP）实现Google Sheets自动化的强大工具

mcp-name: io.github.henilcalagiya/google-sheets-mcp

概述

Google Sheets MCP Server 提供了与任何兼容MCP客户端无缝集成Google Sheets的功能。它通过简单且安全的API层实现了完整的电子表格自动化——包括创建、读取、更新和删除工作表。

特性

  • 支持Google Sheets和表格的完整CRUD操作
  • 可与Continue.dev、Claude Desktop、Perplexity等MCP客户端配合使用
  • 通过Google服务账户进行安全认证
  • 提供全面的Google Sheets自动化工具
  • 通过uvx自动安装

要求

  • Python 3.10+
  • uv包管理器（用于uvx命令）
  • 带有服务账户的Google Cloud项目
  • 兼容MCP的客户端（例如Continue.dev）

安装uv：

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows PowerShell
irm https://astral.sh/uv/install.ps1 | iex

快速开始

1. 设置Google服务账户

步骤1：创建Google Cloud项目

  1. 访问Google Cloud控制台
  2. 点击“选择项目”→“新建项目”
  3. 输入项目名称（例如，“my-sheets-automation”）
  4. 点击“创建”

步骤2：启用所需API

  1. 在您的项目中，转到“API和服务”→“库”
  2. 搜索“Google Sheets API”→点击→“启用”
  3. 搜索“Google Drive API”→点击→“启用”

步骤3：创建服务账户

  1. 转到“IAM和管理”→“服务账户”
  2. 点击“创建服务账户”
  3. 输入服务账户名称（例如，“sheets-mcp-service”）
  4. 点击“创建并继续”
  5. 跳过角色分配→点击“继续”
  6. 点击“完成”

步骤4：生成JSON密钥

  1. 点击您新创建的服务账户电子邮件地址
  2. 转到“密钥”标签页→“添加密钥”→“创建新密钥”
  3. 选择“JSON”格式→点击“创建”
  4. JSON文件会自动下载

步骤5：提取所需值 打开下载的JSON文件，并记录以下值：

示例Google服务账户JSON结构：

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "your-service@your-project.iam.gserviceaccount.com",
  "client_id": "your-client-id",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/your-service%40your-project.iam.gserviceaccount.com"
}

如需更多帮助，请参阅此指南

2. 配置MCP客户端

{
  "mcpServers": {
    "google-sheets-mcp": {
      "command": "uvx",
      "args": ["google-sheets-mcp@latest"],
      "env": {
        "project_id": "your-project-id",
        "private_key_id": "your-private-key-id",
        "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
        "client_email": "your-service@your-project.iam.gserviceaccount.com",
        "client_id": "your-client-id",
        "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/your-service%40your-project.iam.gserviceaccount.com"
      }
    }
  }
}

💡 小贴士： 您可以直接从Google服务账户的JSON文件中复制这些值。JSON文件中的字段名无需更改！

🔄 向后兼容性： 该服务器还支持旧的带有GOOGLE_前缀的变量名（例如GOOGLE_PROJECT_ID），适用于现有配置。

3. 与服务账户共享您的Google电子表格

  • 在网络浏览器中打开目标Google电子表格。
  • 点击分享按钮。
  • 输入服务账户电子邮件（例如，your-service@your-project.iam.gserviceaccount.com），并赋予编辑者权限。
  • 点击发送以提供编辑权限。

🎉 您已设置完毕！ 当需要时，您的MCP客户端将自动安装并运行该包。

许可证

本项目采用MIT许可证——详情见LICENSE文件。

作者

Henil C Alagiya

支持与贡献：

  • 🐛 报告问题：GitHub Issues
  • 💬 提问：在LinkedIn上联系我们
  • 🤝 贡献：欢迎提交拉取请求！