MCP Server Spreadsheet

🚀 Google 表格 MCP 服务器

本项目是一个 Model Context Protocol (MCP) 服务器实现，它能与 Google 表格集成，让 AI 助手可检索和修改电子表格数据。借助此服务器，Claude 能直接与您的 Google 表格数据进行交互。

🚀 快速开始

此服务器可让 Claude 直接与您的 Google 表格数据交互。以下是使用前的演示、特性、先决条件、安装及认证设置等相关信息。

演示

✨ 主要特性

该服务器提供了以下工具来处理 Google 表格：

• get_sheets：检索电子表格的所有工作表信息，包括名称、维度和 ID
• get_sheet_values：从特定工作表中检索值，可选范围指定
• update_cells：更新特定范围内单元格的值
• batch_update_cells：一次性跨不同工作表更新多个范围
• add_sheet：在现有电子表格中添加新工作表，带有自定义维度

📦 安装指南

先决条件

• Node.js（v18 或更高版本）
• 启用了 Google 表格 API 的 Google 云项目
• Google 云身份验证凭据
• Claude Desktop（用于与 Claude 集成）

安装步骤

1. 克隆此仓库：

   git clone https://github.com/yourusername/mcp-server-spreadsheet.git
   cd mcp-server-spreadsheet
   

2. 安装依赖项：

   pnpm install
   

认证设置

此服务器使用 Google 云的应用默认凭据进行认证，以访问 Google 表格。

1. 如果尚未安装，请安装 Google Cloud CLI
2. 登录并授权对 Google 表格的访问：

   gcloud auth application-default login --scopes=openid,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/spreadsheets
   

⚠️ 重要提示

• 确保在 Google Cloud 项目中启用了表格 API。
• 认证完成后，系统会生成必要的凭据文件。

📚 详细文档

开发

项目结构

• src/index.ts：主入口点
• src/tools/：各个 MCP 工具的实现
• src/utils/：实用函数和服务
• src/types/：TypeScript 类型定义

运行测试

pnpm test

环境变量

您可以在项目根目录创建一个 .env 文件，添加以下变量：

# 可选：覆盖 Google API 凭据路径
GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json

# 可选：调试模式
DEBUG=true

故障排除

• 认证错误：确保设置了正确的凭据，并且 Google 表格 API 已在您的 Google Cloud 项目中启用。
• 权限错误：确认您的 Google 账户或服务账户具有访问您尝试操作的表格的权限。
• 服务器连接问题：检查 Claude Desktop 是否正确配置以启动 MCP 服务器。

📄 许可证

本项目采用 MIT 许可证。

💪 贡献

欢迎贡献！请随意提交 Pull Request。