Googlesheetsmcp

Google Sheets MCP 服务器

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

mcp名称：io.github.henilcalagiya/google-sheets-mcp

概述

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

特点/功能

• 对Google Sheets和表格提供完整的CRUD（创建、读取、更新、删除）支持
• 与Continue.dev、Claude Desktop、Perplexity及其他MCP客户端兼容
• 通过Google服务帐户进行安全认证
• 用于Google Sheets自动化的综合工具
• 通过自动安装 uvx

要求

• Python 3.10+（或“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云项目

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

步骤2：启用所需API

1. 在你的项目中，进入“APIs和服务”→“库”
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文件，并记下这些值：

• project_id （例如，“my-sheets-automation-123456”）
• private_key_id （例如，“a4ae73111b11b2c3b07cc01006e71eb8230dfa29”）
• private_key （以“-----BEGIN PRIVATE KEY-----”开头的长私钥）
• client_email （例如，“sheets-mcp-service@my-sheets-automation-123456.iam.gserviceaccount.com”）
• client_id （例如，“113227823918217958816”）
• client_x509_cert_url （例如，“https://www.googleapis.com/robot/v1/metadata/x509/sheets-mcp-service%40my-sheets-automation-123456.iam.gserviceaccount.com”）

示例 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许可证授权——详见 许可证 详情请查阅文件。

作者

Henil C Alagiya（人名，根据音译可译为“亨尼尔·C·阿拉吉亚”，但具体译名可能因个人习惯或官方翻译而异）

• GitHub: @henilcalagiya（注：这是一个社交媒体用户名，直接翻译为中文仍为原样，因为用户名通常不翻译，保持原样以识别特定用户）
• LinkedIn（领英）: Henil C Alagiya（这个名字在中文中没有直接对应的翻译，通常人名在翻译时会保持原样或根据发音进行音译，但在此处由于其独特性，我们直接保留原名）

支持与贡献：

• 🐛 蚜虫 报告问题:
• 💬（这个表情符号在中文中通常没有直接对应的翻译，它表示“文字/对话”的意思，可以理解为“说”或“聊天”的概念。） 问题联系我 LinkedIn（领英）
• 🤝（握手） 贡献欢迎提交拉取请求！