Google Sheet MCP

Google Sheets MCP 服务器

一个模型上下文协议（MCP）服务器，可与Google Sheets实现无缝集成，使AI代理能够读取、搜索并智能修改电子表格数据。

特点/特性

• 📊（表格/数据图表） 读取电子表格数据 按文件、工作表或特定范围
• ✏️ 智能电池更新 进行部分文本替换
• 🔍 翻译为中文是：“🔍”（这个符号本身没有直接的中文翻译，它通常用于表示搜索或放大镜的图标，在中文语境中可能被理解为“搜索”或“放大镜”的意思，但直接作为符号使用时，一般保留原样。）不过，如果非要给出一个与中文语境下含义相近的表述，可以是“🔍（搜索/放大镜图标）”。但更常见的是直接使用该符号本身。 搜索和筛选 跨表格的功能
• 📝（便签/记事本图标，无具体文字含义） 保持格式 以及在更新期间的公式
• 🔐 安全的OAuth 2.0 认证
• ⚡（闪电符号，无具体含义，可表示快速、能量、惊喜等） 批处理操作 为了进行高效的批量更新
• 🛡️（盾形符号，常用于表示保护、防御或安全） 类型安全 提供完整的TypeScript支持

快速入门

先决条件

• Node.js 18及以上版本
• 已启用Sheets API的Google云项目
• 来自 Google Cloud Console 的 OAuth 2.0 凭据

安装

npm install

配置

1. 启用Google Sheets API

- 首选 Google 云控制台 - 创建一个新项目或选择一个现有项目 - 启用“Google Sheets API”和“Google Drive API” - 创建OAuth 2.0凭据（桌面应用程序）

1. 设置环境变量

创建一个 .env 文件：

# Google OAuth 설정
GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth/callback

# 서비스 계정 설정 (선택사항)
GOOGLE_SERVICE_ACCOUNT_KEY_PATH=./path/to/service-account-key.json

1. 启动MCP服务器

# Development
npm run dev

# Production
npm run build
npm start

1. 安装MCP服务器

# add this to mcp.json etc.
"google-sheets-mcp-server": {
      "command": "node",
      "args": ["YOUR_PATH/google-sheets-mcp/dist/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID":"YOUR_CLIENT_ID",
        "GOOGLE_CLIENT_SECRET":"YOUR_CLIENT_SECRET",
        "GOOGLE_REDIRECT_URI":"http://localhost:3000/oauth/callback",
        "NODE_ENV":"development",
        "LOG_LEVEL":"info"
      }
    }

发展

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run tests
npm test

# Lint code
npm run lint

# Format code
npm run format

可用工具

阅读工具

• sheets_list_files - 列出可访问的电子表格
• sheets_list_sheets - 在电子表格中列出工作表
• sheets_read_data - 从一个工作表中读取所有数据
• sheets_read_range - 从特定范围读取数据
• sheets_search - 在单元格中搜索文本

更新工具

• sheets_update_cell - 更新单个单元格
• sheets_update_range - 更新多个单元格
• sheets_smart_replace - 智能文本替换
• sheets_append_rows - 添加新行

管理工具

• sheets_create_sheet - 创建一个新工作表
• sheets_delete_sheet - 删除一个工作表
• sheets_rename_sheet - 重命名一个工作表

文档

• API 参考文档 - 完整的工具文档
• 教程 - 分步骤指南
• 做出贡献 - 如何做出贡献

特点/功能

• ✅ OAuth 2.0 认证 - 安全集成Google账户
• ✅（对勾符号，通常表示正确、同意、确认等意思） 服务账户支持 - 用于自动化工作流
• ✅ 智能文本替换 - 部分文本更新，同时保留上下文
• ✅ 批处理操作 - 高效的批量更新
• ✅ 错误处理 - 全面的错误管理，包含重试逻辑
• ✅ 速率限制 内置API配额管理
• ✅ 类型安全 - 完全支持TypeScript
• ✅ 综合测试 - 单元测试和集成测试

演出

• 读取操作对于最多包含10,000个单元格的工作表，处理时间少于2秒
• 写操作对于最多1,000个细胞的批次，处理时间少于5秒
• 智能替换对于最多5,000个单元格的工作表，处理时间少于3秒
• 速率限制默认每分钟60个请求

安全

• 使用系统密钥链安全存储OAuth令牌
• 所有API通信均使用HTTPS
• 未记录敏感数据
• 敏感电子表格可设置为只读模式
• 输入验证和清理

许可证

麻省理工学院（MIT）