Google Sheet MCP Server

🚀 Google Sheets MCP 服务器

这是一个强大的基于模型上下文协议（MCP）的服务器实现，专为与 Google Sheets API 实现无缝集成而设计。借助该服务器，AI 助手能够轻松创建、读取、更新和管理 Google 表格，为表格操作带来极大便利。

✨ 主要特性

• 支持创建、读取、更新和删除 Google 表格，实现全生命周期管理。
• 可使用单元格级别操作管理表格数据，操作灵活精准。
• 能够格式化单元格和范围，让表格呈现更美观。
• 支持与其他用户共享电子表格，方便团队协作。
• 具备搜索电子表格功能，快速定位所需表格。
• 提供全面的认证选项，满足不同场景需求。

📦 安装指南

先决条件

• Node.js（v16 或更高版本）
• 已启用 Google Sheets API 的 Google Cloud 项目
• Google Cloud 身份验证凭据（见下文）

安装步骤

1. 克隆仓库：

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

2. 安装依赖项：

   npm install
   

3. 设置身份验证：
   • 基于 .env.example 模板创建一个 .env 文件。
   • 将 Google Cloud 凭据添加到其中。
4. 构建项目：

   npm run build
   

5. 启动服务器：

   npm start
   

OAuth 设置

对于需要用户同意的操作（如创建/编辑表格），您需要 OAuth 凭证：

1. 在 Google Cloud 控制台中创建 OAuth 凭证。
2. 更新 src/get-refresh-token.js 中的 CLIENT_ID 和 CLIENT_SECRET。
3. 安装所需的依赖项：

   npm install open server-destroy
   

4. 运行脚本来获取刷新令牌：

   node src/get-refresh-token.js
   

5. 跟随浏览器提示进行授权。
6. 将刷新令牌复制到 .env 文件中。

🔧 技术细节

认证选项

此 MCP 服务器支持多种认证方法：

1. 服务账户认证（生产推荐）
   • 提供指向服务账户密钥文件的路径。
   • 或直接提供服务账户 JSON 内容。
2. API Key 认证（开发更简单）
   • 提供 Google API 密钥。
3. OAuth2 认证（用于特定用户操作）
   • 提供 OAuth 客户端 ID、客户端密钥和刷新令牌。

💻 使用示例

基础用法

服务器提供以下工具：

• google_sheets_create：创建新的 Google 表格
• google_sheets_get：通过 ID 获取 Google 表格
• google_sheets_update_values：更新 Google 表格中的值
• google_sheets_append_values：向 Google 表格追加值
• google_sheets_get_values：从 Google 表格获取值
• google_sheets_clear_values：清除 Google 表格中的值
• google_sheets_add_sheet：在现有表格中添加新工作表
• google_sheets_delete_sheet：删除表格中的工作表
• google_sheets_list：列出对已认证用户可用的 Google 表格
• google_sheets_delete：删除 Google 表格
• google_sheets_share：与特定用户共享 Google 表格
• google_sheets_search：按标题搜索 Google 表格
• google_sheets_format_cells：格式化 Google 表格中的单元格
• google_sheets_verify_connection：验证与 Google 表格 API 的连接

高级用法

以下是使用此 MCP 服务器与 Claude 一起工作的示例：

现在您可以使用 Google 表格！尝试以下命令：

1. 创建新的电子表格：
   "创建一个标题为 '月度预算' 的新 Google 表格"

2. 向电子表格添加数据：
   "向我的月度预算电子表格中添加支出类别和金额"

3. 格式化电子表格：
   "将标题行设置为粗体并居中"

4. 共享电子表格：
   "将我的月度预算电子表格与 john@example.com 分享"

📄 许可证

本项目采用 MIT 许可证。