Googlesheet MCP

🚀 Google Sheets MCP 服务器

本 MCP 服务器提供了与 Google 表格进行交互的工具，可实现对电子表格数据的读取、写入和更新操作，为数据处理提供便利。

🚀 快速开始

此 MCP 服务器可让你轻松与 Google 表格交互，以下是使用前的准备及操作步骤。

✨ 主要特性

• 提供与 Google 表格交互的工具，支持读取、写入和更新电子表格中的数据。

📦 安装指南

先决条件

• Python 3.8 或更高版本
• Google Cloud Platform 账户
• 一个你想交互的 Google 表格

安装步骤

1. 克隆此仓库：

git clone <your-repository-url>
cd mcp-server-demo

2. 安装所需的包：

pip install google-auth-oauthlib google-auth-httplib2 google-api-python-client

3. 下载并放置 credentials.json 文件：
   • 从你的 Google Cloud Console 下载 credentials.json 文件。
   • 将 credentials.json 文件放在与 main.py 同一目录中。
   • 确保文件名正好是 credentials.json。

配置 Google Cloud Platform 凭据

1. 前往 Google Cloud Console。
2. 创建新项目或选择现有项目。
3. 启用 Google Sheets API：
   • 转到 "APIs & Services" > "Library"。
   • 搜索 "Google Sheets API"。
   • 点击 "Enable"。
4. 创建凭据：
   • 转到 "APIs & Services" > "Credentials"。
   • 点击 "Create Credentials" > "Service Account"。
   • 填写服务账户详细信息：
     • 名称：选择一个描述性名称。
     • ID：自动生成。
     • 描述：可选描述。
   • 点击 "Create and Continue"。
   • 对于角色，选择 "Editor"（或根据需要选择适当的角色）。
   • 点击 "Continue" 然后是 "Done"。
5. 创建并下载密钥：
   • 在服务账户列表中，点击你新创建的账户。
   • 转到 "Keys" 标签页。
   • 点击 "Add Key" > "Create new key"。
   • 选择 "JSON" 格式。
   • 点击 "Create"，JSON 文件会自动下载。
6. 保存凭据：
   • 将下载的 JSON 文件重命名为 credentials.json。
   • 放置在 mcp-server-demo 目录中。
7. 分享你的 Google 表格：
   • 打开你的 Google 表格。
   • 点击 "Share" 按钮。
   • 添加服务账户电子邮件（在 credentials.json 文件的 client_email 字段中找到）。
   • 给它 "Editor" 访问权限。

安装 MCP 服务器

1. 下载 MCP 服务器：

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

2. 安装依赖项：

pip install -r requirements.txt

3. 启动 MCP 服务器：

python server.py

💻 使用示例

基础用法

以下是一些常用命令的使用示例：

列出所有命令

mcp list-commands

获取表格数据

mcp get-table --spreadsheet_id YOUR_SPREADSHEET_ID --sheet_name YOUR_SHEET_NAME

添加新记录

mcp add-record --spreadsheet_id YOUR_SPREADSHEET_ID --sheet_name YOUR_SHEET_NAME --data "value1,value2\nvalue3,value4"

更新记录

mcp update-record --spreadsheet_id YOUR_SPREADSHEET_ID --sheet_name YOUR_SHEET_NAME --identifier RECORD_IDENTIFIER --updates "column1=value1\ncolumn2=value2"

📚 详细文档

安全注意事项

⚠️ 重要提示

• 凭据管理：从版本控制系统中排除 credentials.json，定期轮换你的凭据，只与必要的服务账户共享你的 Google 表格。
• 权限控制：确保服务账户电子邮件已作为编辑添加到表格，验证 credentials.json 文件的有效性和安全性。
• 数据保护：定期备份重要数据，使用 HTTPS 传输敏感信息，遵守相关的隐私法规和政策。

故障排除

常见问题

• 身份验证错误：
  • 确保服务账户电子邮件已作为编辑添加到表格。
  • 验证 credentials.json 文件的有效性和完整性。
  • 检查 Google Sheets API 是否在你的 Google Cloud 项目中启用。
• 权限错误：
  • 确认服务账户具有正确的权限。
  • 验证表格是否已与服务账户电子邮件共享。
  • 检查表格 ID 是否正确。
• 数据格式错误：
  • 确保数据格式符合预期结构。
  • 检查表格是否有所需的列（id 或名称）。
  • 验证数据的列数与表格一致。

联系方式

如有任何问题或疑问，请按以下步骤操作：

1. 检查日志中的错误信息。
2. 验证你的设置是否符合上述说明。
3. 确保所有先决条件已满足。
4. 联系 aryanpandit17032002@gmail.com。