AI导哈

表格数据处理服务

一个与Google Sheets无缝集成的MCP服务器，使AI代理能够读取、搜索和智能修改电子表格数据。

  • by ainetwork-ai
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ainetwork-ai/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凭据（桌面应用程序）

  2. 设置环境变量

创建一个 .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 - 重命名一个工作表

文档

特点/功能

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

演出

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

安全

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

许可证

麻省理工学院（MIT）

相关 MCP